Me

The calling principal. For agent tokens user is the token owner and agent_token is set.

Fields

Field	Type	Description
principal *	object
user	User or any or null
agent_token	AgentToken or any or null
scopes *	array of Scope	Effective scopes of this credential.
workspaces *	array of WorkspaceMembership
csrf_token	string or null	Present for cookie sessions. Send as Guv-CSRF on state-changing requests.
session_expires_at	string (date-time) or null

* always present

Example

{
  "principal": {
    "type": "user",
    "id": "string"
  },
  "user": {
    "id": "usr_01jbx2m9k7q4r8t5v6w3y0z1us",
    "email": "stewart@primecarers.co.uk",
    "name": "Stewart Webb",
    "avatar_url": null,
    "github_login": "stewartwebb",
    "has_passkey": true,
    "is_platform_admin": true,
    "default_workspace_id": "ws_01jbx2m9k7q4r8t5v6w3y0z1ws",
    "created_at": "2026-10-22T09:00:00Z"
  },
  "agent_token": {
    "id": "tok_01jbx2m9k7q4r8t5v6w3y0z1tk",
    "workspace_id": "ws_01jbx2m9k7q4r8t5v6w3y0z1ws",
    "name": "claude-code-on-stewart-laptop",
    "description": "Claude Code on Stewart's MacBook",
    "prefix": "guv_agt_Qm4x",
    "scopes": [
      "projects:read",
      "deploy:preview",
      "deploy:staging",
      "logs:read",
      "secrets:write-only",
      "db:branch"
    ],
    "projects": null,
    "environments": [
      "preview",
      "staging"
    ],
    "budget": {
      "spend_increase_per_day": {
        "amount": "10.00",
        "currency": "GBP",
        "display": "£10.00"
      }
    },
    "approval_channel": [
      "push",
      "email"
    ],
    "status": "active",
    "summary": [
      "Can deploy to staging and previews.",
      "Cannot touch production without your approval.",
      "Can set secrets but never read them.",
      "Can raise spend by up to £10.00 a day."
    ],
    "created_by": {
      "type": "user",
      "id": "usr_01jbx2m9k7q4r8t5v6w3y0z1us",
      "display": "Stewart Webb"
    },
    "expires_at": "2026-11-22T09:00:00Z",
    "last_used_at": "2026-10-23T13:58:00Z",
    "revoked_at": null,
    "created_at": "2026-10-23T09:00:00Z"
  },
  "scopes": [
    "deploy:staging"
  ],
  "workspaces": [
    {
      "id": "string",
      "slug": "string",
      "name": "string",
      "role": "owner",
      "plan": "trial"
    }
  ],
  "csrf_token": "string",
  "session_expires_at": "2026-10-22T13:05:00Z"
}

Used by

• Who am I