Attach an agent to a connection
Grants
Attach an agent to a connection
Identical operation to PUT /agents/{agentId}/grants/connections/{connectionId}, addressed connection-first. Same body, same validation, same response — the updated grant set of the agent.
PUT
Attach an agent to a connection
Authorizations
API key obtained from the dashboard or GET /user/api-key
Body
application/json
- 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.
Available options:
full Response
The agent's updated grant set
An agent's full grant set — returned by grant reads and by every grant write.