Passer au contenu principal
GET
Introspect the authenticated credential, its organization, and credits
Renvoie { organization, api_key, credits } pour la clé présentée — l’id et le nom de l’organisation, les métadonnées sûres de la clé (id, name, prefix, scopes, expiration — jamais le secret) et le solde de credits disponible de l’organisation. C’est le moyen le plus rapide de confirmer qu’une clé fonctionne. GET /me nécessite n’importe quelle clé valide et aucun scope spécifique.

Autorisations

Authorization
string
header
requis

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

Réponse

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
requis

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

api_key
ApiKeyInfo · object
requis

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

credits
CreditsInfo · object
requis

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

credential_type
string
défaut:api_key
Allowed value: "api_key"