Introspect the principal behind the agent key

GET

/v1/auth/me

• Production
• Local

Requires only a valid key (any scope), so an agent can always read its own authority.

Authorizations

• AgentKey

Responses

200

The verified principal.

The verified principal behind an agent key. org_id/project_id are the FIXED org/project the key is bound to (resolved from the stored key, never client input). There is NO mutable project selector for a scoped key; whoami is the canonical project-visibility surface; project selection happens when the human/admin issues the enrollment token or agent key.

object

customer_id

string

org_id

The fixed org the key is bound to.

string

project_id

The fixed project the key is bound to.

string

agent_id

string

key_id

string

scopes

Array<string>

401

Missing or invalid credential.

The canonical error envelope. error is a stable machine code.

object

error

required

Stable error code (e.g. unauthorized, forbidden, not_found, invalid, quota_exceeded, rate_limited).

string

Example

forbidden

message

Human-readable detail (never leaks internals).

string

Example

missing required scope