/{app_slug}/v1/agent-access/introspectAuthVerify 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*stringThe app slug.
Request body
token*stringThe agent access token your resource server received.
Response · 200 The verdict.
active*booleanThe token is usable now. When false, no other field is present.
substringEnd user id.
client_idstringThe client id of the agent.
client_namestringThe self-declared client name, for your audit trail.
scopestringSpace-separated granted scopes.
audstringThe resource the token is for.
expnumberExpiry, Unix seconds.
grant_idstringThe connection the token belongs to.
Example: "agr_9xY…"
grant_created_atstring · date-timeWhen the user approved. Compare with your own revocation cut-offs.
contextobjectThe 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": {}
}