Skip to main content
GET
Get the caller

Authorizations

Authorization
string
header
required

An API token for one organization. You create and revoke tokens in the dashboard. A token scoped to one App can reach only that App, so give that kind of token to an agent. An organization-wide token can create a short-lived one with POST /api/tokens.

Scopes

apps:read
OAuth

See the organization's Apps, with their files, deployments, and logs.

apps:read
DPoP

Response

The person, organization, role, and credential.

user
object
required

The person the credential acts for. An API token acts for the person who created it.

organization
object
required

The organization that the credential reaches.

role
enum<string>
required

The person's role in the organization. Only an owner or admin can create, delete, publish, or unpublish Apps, or change their production settings.

Available options:
owner,
admin,
member
credential
object
required

The credential that the request sent.