Me — Core API
Caller identity. Answers "who does the Core API consider me to be?" for the presented credential — the credential's type and the verified accounts it can act on. Use it to resolve the account for an API key without configuration.
Base URL: https://api.authpi.com — explore every endpoint in the
interactive Core API reference.
GET/v1/me
Get Caller Identity
Returns who the Core API considers the caller to be, based on the presented credential — the equivalent of AWS STS GetCallerIdentity.
The response has one uniform shape for every credential type:
typeidentifies the credential:api_key(HTTP Basic),user(Bearer JWT), orpersonal_token(Bearer PAT).accountsis always an array of the verified accounts this credential can act on, each with the authorization scopes held on it. Account API keys yield exactly one entry; user tokens one per account membership; credentials with no account access yield an empty array.- Each account entry carries both
account_idand the underlyingorg_id— accounts are facades over organizations in AuthPI's own issuer. organizationsis always an array of the tenant organizations this credential can act on — organizations inside an issuer that are not accounts. An organization-scoped API key yields exactly one entry with the key's scopes; account credentials yield an empty array.
Use this to resolve the account for a credential without configuration: when accounts has exactly one entry, that is the account to operate on. The admin SDKs use this endpoint to make accountId optional.
This is also the verification call for tenant credentials: a customer's API that receives an organization API key presents it here and reads back which organization is calling (organizations[0].org_id) and what it may do (organizations[0].scopes) — the equivalent of AWS STS GetCallerIdentity for tenant machine credentials. Each successful verification emits an api-key.verified event.
Responses
| Code | Description | Schema |
|---|---|---|
| 200 | The caller's identity and verified account access | object |
| 401 | Unauthorized - Authentication is required or has failed. | ApiError |