External apps
Get your own External Application record
Self-introspection — an External Application reads its own record, including the catalog permissions its role grants hold. Requires no permission, only an External Application credential.
GET
Get the calling External Application's own record
The reference panel describes the current v3 operation. The notes below describe its v2 compatibility API. Follow the v3 request schema for current calls: v3 can move identifiers from the body or query into the URL. Keep the v2 method, path, and payload together when using the compatibility API.
v2 compatibility notes
Returns the record of the External Application making the request: its id, client id, name, status, the catalog permissions its role grants hold (allowedScopes), access-token TTL, owner,
and budget posture.
This is the counterpart to Get an External Application by ID,
which requires the
apps:manage permission. An ordinary App does
not hold it, so before this endpoint existed an App had no way to read its own configuration.Authorization
GET /api/v2/me requires no permission. It is authorized by presenting an External Application
credential — either an OAuth2 access token or the legacy companion API key — because every fact
it returns is about the caller.
The endpoint takes no identifier: not a path segment, not a query parameter, not a body
field. The application is determined solely by the credential you present, so there is no way to
request another application’s record.
A plain platform API key has no External Application to describe and receives 403 Forbidden.
Common uses
- Confirm which permissions the App’s roles hold before debugging a
403from another route.allowedScopesis computed: the catalog permissions the App’s role grants hold, sorted. It is not narrowed by the token you present, and it cannot be written. A403names the missing permission inerror.requiredPermission. - Read
tokenTtlSecondsto size your token refresh interval instead of hard-coding it. - Check
statusto distinguish a deactivated application from a credential problem. - Read
budgetsto surface remaining headroom in your own UI.

