Get Current Account

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

opentrain auth status --json

{}

{
  "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"
  }
}

GET

api

public

auth

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

opentrain auth status --json

{}

{
  "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"
  }
}

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

actor

object

The user behind the token.

Show actor fields

userId

string

The actor’s user ID.

string | null

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

firstName

string | null

First name, if set.

lastName

string | null

Last name, if set.

fullName

string | null

Convenience concatenation of first and last name.

userType

string | null

The platform role, e.g. EMPLOYER.

token

object

The authenticating token.

Show token fields

string

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

label

string | null

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

scopes

string[]

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

ownerOrganizationId

string | null

Organization the token is bound to, if any.

account

object

The account context requests operate in.

Show account fields

kind

string

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

organizationId

string | null

The organization ID (null for personal).

ownerUserId

string | null

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

memberRole

string | 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

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

opentrain auth status --json

{}

{
  "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"
  }
}

Revoke Token

Search Jobs

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors