Core API Reference

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 — see the Core API overview for authentication, pagination, and idempotency, or try these endpoints in the interactive 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:

  • type identifies the credential: api_key (HTTP Basic), user (Bearer JWT), or personal_token (Bearer PAT).
  • accounts is always an array of the verified accounts this credential can act on, each with the authorization scopes held on it. API keys yield exactly one entry; user tokens one per account membership; credentials with no account access yield an empty array.
  • Each entry carries both account_id and the underlying org_id — accounts are facades over organizations in AuthPI's own issuer.

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.

Responses

CodeDescriptionSchema
200The caller's identity and verified account accessobject
401Unauthorized - Authentication is required or has failed.ApiError