Attach a connection to an agent
Attach an app connection to an agent, or change what the agent may do with it. Takes effect immediately — there is no draft/publish step.
Send {"access": "full"} for every tool the app supports, or {"access": "custom", "allow": [...], "ask": [...]} to name tools: allow runs freely, ask pauses each call for human approval, and everything unnamed is blocked.
Authorizations
API key obtained from the dashboard or GET /user/api-key
Body
- Full access
- Custom access
The grant to write. Two forms:
{"access": "full"}— every tool the app supports.{"access": "custom", "allow": [...], "ask": [...]}— named tools only.allowruns freely,askpauses for human approval, everything unnamed is blocked.
Validation laws on custom: the two lists together must name at least one tool (an all-blocked grant is a detach — use DELETE), and a tool can't appear in both lists. Tool ids come from GET /apps/{provider}/permission-definition.
full Response
The agent's updated grant set
An agent's full grant set — returned by grant reads and by every grant write.