Skip to main content
GET
Introspect the authenticated credential, its organization, and credits
Returns { organization, api_key, credits } for the presented key — the organization id and name, the key’s safe metadata (id, name, prefix, scopes, expiry — never the secret), and the organization’s available credit balance. This is the fastest way to confirm a key works. GET /me requires any valid key and no specific scope.

Authorizations

Authorization
string
header
required

Organization API key (Authorization: Bearer samsa_sk_...) or OAuth 2.1 access token (Authorization: Bearer samsa_at_...).

Response

Successful Response

GET /me body for an API-key principal (ADR §10, scope item 5).

SAM-776 (DAM ADR §5): field-preserving and additively backward-compatible — the pre-existing fields are unchanged; the NEW defaulted credential_type: "api_key" discriminator is the ONE locked additive delta for key callers, and it makes this arm of the discriminated :data:PublicMeResponse union.

organization
OrganizationInfo · object
required

The key's organization (the billing / rate-limit identity, ADR §3.1).

api_key
ApiKeyInfo · object
required

The presented key's safe, re-displayable metadata (never secrets).

credits
CreditsInfo · object
required

The organization's remaining monthly plan-pool credits (GET /me).

credential_type
string
default:api_key
Allowed value: "api_key"