Skip to content

Read the caller's own identity and scopes

GET
/v1/me
curl --request GET \
--url https://example.com/v1/me \
--header 'Authorization: Bearer <token>'

Echoes the identity the gateway derived from the caller’s token: the tenant it will scope every request to, the acting user, and the effective OAuth scopes. Nothing here is new authority — every field comes from the validated token the caller presented — and no lookup is performed, so no other tenant’s data can reach the response.

It exists for clients that legitimately cannot read their own token: a console whose backend-for-frontend holds the bearer server-side has no other way to name the tenant it is administering, or to know whether the operator may read invocation bodies.

The caller’s identity.

Media typeapplication/json

The caller’s own identity, derived from its validated token.

object
tenant_id
required

The tenant every request from this caller is scoped to.

string
user_id
required

The acting user (the token’s subject claim).

string
scopes
required

Effective OAuth scopes. Empty when the token carries none.

Array<string>
can_read_invocation_bodies
required

Whether the token carries invocations:read_body. Named rather than left to be re-derived from scopes, because it gates one specific high-risk surface and a client that string-matches a scope name will eventually match the wrong one.

boolean
Examplegenerated
{
"tenant_id": "example",
"user_id": "example",
"scopes": [
"example"
],
"can_read_invocation_bodies": true
}

Missing or invalid bearer token, or the token’s tenant/user claims are absent. No body.