The flow
- Invitation. In the app, under Integrations, the person starts a connection. They get a short invitation to paste into the assistant.
- Intent. The assistant registers what it is and what it wants to be called, and receives a verification link to hand back.
- Approval. The person opens that link, signs in, and sets the two ceilings: per request and per day. A short code confirms the approval.
- Tokens. The assistant exchanges the code for its own access and refresh tokens. The secret itself never passes through the assistant’s prompt.
What a connection may do
Each call is checked against the ceilings at the moment it reserves money, so a
burst of parallel calls cannot slip past them.
Connections or API keys?
Use a connection when a person is in the loop. Use an API key when a server
runs on its own.