Skip to navigation
API Referencewhoami

Get the caller identity and permissions

Returns the kind of credential, the account, and the permissions that the credential has now. For an API token, also its name, last four characters, expiry and last use.

Authentication

AuthorizationBearer

API token, for example amcld_.... Create one in the dashboard.

Response

kindenum

The kind of credential: api-token for an API token, legacy-api-key for an API key header pair, delegated for an app that acts as a user, first-party for the dashboard.

Allowed values:
accountobject
The account that the credential belongs to.
permissionslist of strings
The permissions that the credential has now.
userobjectOptional
The user, for the dashboard and for an app that acts as a user.
tokenobjectOptional
The API token, for an API token.
appobjectOptional
The app, for an app that acts as a user.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error