Token introspection (RFC 7662)

Reports whether a token is currently active, per OAuth 2.0 RFC 7662.

What active means (RFC 7662 §2.2) — the token was issued by this authorization
server, has not been revoked, and is within its validity window. That is the whole
determination. The token's aud is reported in the response and takes part in no
decision: this service issues several audiences (ankasecure-admin for human users,
ankasecure-core for application actors), and all of them introspect identically.

Both token planes are searched. The value may be a JWT access token or an opaque
refresh token. Per RFC 7662 §2.1 the optional token_type_hint only reorders the
search — it never ends it, so a wrong hint still finds the token. An unrecognized or
empty hint is treated as absent and is never an error.

Request formatapplication/x-www-form-urlencoded, as RFC 7662 §2.1 specifies.
A JSON body is answered 400 carrying the RFC 6749 §5.2 error object, not 415 — see
the 400 response below.

Authorization — requires platform.token.read (all tenants; restricted to
PRIVATE_CLOUD and ON_PREMISE deployments) or auth.tenant.token.read (the caller's own
tenant, in every deployment mode).

Disclosure — an inactive token yields {"active": false} and nothing else: no
claims, and no distinction between expired, revoked, belonging to another tenant, and
never having existed. A token belonging to another tenant is reported inactive rather
than refused, because a 403 would confirm the token exists while declining to
describe it.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Form Data

Form-encoded introspection request (RFC 7662 §2.1)

OAuth 2.0 token introspection request (RFC 7662). Submitted as application/x-www-form-urlencoded per RFC 7662 section 2.1 - this schema documents the FORM FIELDS, not a JSON body.

string
required
length ≥ 1

Token to introspect - a JWT access token or an opaque refresh token

string
enum

Optional hint about token type (access_token or refresh_token)

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json