Get Current Account

Returns the principal behind the bearer token: who the actor is, what the token can do, and which account context it operates in. The natural first call of any session — use it to confirm the token works and to discover your scopes before probing capabilities.

Requirements: any valid token — no specific scope.

Request

No parameters.

Response

actorobject

The user behind the token.

actor fields

userIdstring

The actor’s user ID.

emailstring | null

The account email, if set. Unclaimed agent accounts have no email until a human claims them.

firstNamestring | null

First name, if set.

lastNamestring | null

Last name, if set.

fullNamestring | null

Convenience concatenation of first and last name.

userTypestring | null

The platform role, e.g. EMPLOYER.

tokenobject

The authenticating token.

token fields

idstring

Token ID — usable with DELETE /tokens/{tokenId}.

labelstring | null

The token’s name (e.g. "ci-runner", "Agent token (pre-claim)").

scopesstring[]

The token’s granted scopes. :write scopes imply the matching :read at enforcement time, but this list shows exactly what was granted.

ownerOrganizationIdstring | null

Organization the token is bound to, if any.

accountobject

The account context requests operate in.

account fields

kindstring

employer_organization when the actor belongs to an employer organization, otherwise personal.

organizationIdstring | null

The organization ID (null for personal).

ownerUserIdstring | null

The organization owner’s user ID (null for personal).

memberRolestring | null

The actor’s role in the organization, e.g. OWNER (null for personal).

Errors

Status	code	Meaning
401	UNAUTHORIZED	Missing, invalid, expired, or revoked token
404	NOT_FOUND	The token’s user no longer exists

Request examples

curlCLIMCP: opentrain_auth_status

curl

curl -sS https://app.opentrain.ai/api/public/v1/auth/me \
  -H "Authorization: Bearer $OT_API_TOKEN"

CLI

opentrain auth status --json

MCP: opentrain_auth_status

{}

Response examples

200

{
  "actor": {
    "userId": "<USER_ID>",
    "email": "owner@example.com",
    "firstName": "Mira",
    "lastName": "Chen",
    "fullName": "Mira Chen",
    "userType": "EMPLOYER"
  },
  "token": {
    "id": "<TOKEN_ID>",
    "label": "ci-runner",
    "scopes": ["jobs:read", "jobs:write", "proposals:read", "payments:read"],
    "ownerOrganizationId": null
  },
  "account": {
    "kind": "employer_organization",
    "organizationId": "<ORGANIZATION_ID>",
    "ownerUserId": "<USER_ID>",
    "memberRole": "OWNER"
  }
}