Auth API reference

Auth API · Consumer-Agent-Access

get/{app_slug}/v1/agent-access/grantsAuth

List 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*string

The app slug.

Query parameters

limitinteger

Page size, 1 to 200 (default 50).

cursorobject

`pagination.next_cursor` of the previous page.

resourceobject

Only connections to this resource.

account_idstring · uuid

Only this end user's connections.

contextobject

A JSON object (at most 1 KB); a grant matches when its context contains it.

Response · 200 The connections.

data*array

Live connections, newest first.

pagination*object

Cursor pagination.

Example

Request

GET https://api.auth.productcraft.co/{app_slug}/v1/agent-access/grants
Authorization: Bearer YOUR_TOKEN

Response

{
  "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": {}
}