/{app_slug}/v1/agent-access/grantsAuthList the app's agent connections (all end users)
For your own admin views, e.g. a workspace owner's list of every member's connected agents. Live connections only (not revoked, not expired), newest first, cursor paged. `context` narrows by JSON containment against the context your app stored at approval: `{"workspace_ids":["tnt_…"]}` returns the connections that include that workspace. Requires `auth.agent_access.grants.manage` on the app.
Path parameters
app_slug*stringThe app slug.
Query parameters
limitintegerPage size, 1 to 200 (default 50).
cursorobject`pagination.next_cursor` of the previous page.
resourceobjectOnly connections to this resource.
account_idstring · uuidOnly this end user's connections.
contextobjectA JSON object (at most 1 KB); a grant matches when its context contains it.
Response · 200 The connections.
data*arrayLive connections, newest first.
pagination*objectCursor pagination.
Example
Request
GET https://api.auth.productcraft.co/{app_slug}/v1/agent-access/grants
Authorization: Bearer YOUR_TOKENResponse
{
"data": [
{
"id": "agr_9xY…",
"account": {},
"client": {},
"resource": "https://mcp.example.com/mcp",
"scopes": [
"string"
],
"context": {},
"created_at": "2026-01-01T00:00:00.000Z",
"last_used_at": "2026-01-01T00:00:00.000Z",
"expires_at": "2026-01-01T00:00:00.000Z"
}
],
"pagination": {}
}