Auth API reference

Auth API · Consumer-Agent-Access

post/{app_slug}/v1/agent-access/introspectAuth

Verify an agent access token (RFC 7662 shape)

For your resource server: is this agent token usable right now, for which user, client, scopes and grant context? Checks the signature, issuer, single audience, expiry, that the connection is live and the user active. Inactive is exactly `{"active": false}`. Cache positives for at most a few seconds: a Disconnect must take effect quickly. Own per-app bucket of 1200 calls a minute (429 with `Retry-After`). Requires `auth.agent_access.introspect` on the app.

Path parameters

app_slug*string

The app slug.

Request body

token*string

The agent access token your resource server received.

Response · 200 The verdict.

active*boolean

The token is usable now. When false, no other field is present.

substring

End user id.

client_idstring

The client id of the agent.

client_namestring

The self-declared client name, for your audit trail.

scopestring

Space-separated granted scopes.

audstring

The resource the token is for.

expnumber

Expiry, Unix seconds.

grant_idstring

The connection the token belongs to.

Example: "agr_9xY…"

grant_created_atstring · date-time

When the user approved. Compare with your own revocation cut-offs.

contextobject

The context your app stored at approval.

Example

Request

POST https://api.auth.productcraft.co/{app_slug}/v1/agent-access/introspect
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "token": "string"
}

Response

{
  "active": false,
  "sub": "string",
  "client_id": "string",
  "client_name": "string",
  "scope": "string",
  "aud": "string",
  "exp": 0,
  "grant_id": "agr_9xY…",
  "grant_created_at": "2026-01-01T00:00:00.000Z",
  "context": {}
}