# Me

> The calling principal.

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

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `principal` * | object |  |
| `user` | [User](/docs/api/objects/user/) or any or null |  |
| `agent_token` | [AgentToken](/docs/api/objects/agent-token/) or any or null |  |
| `scopes` * | array of [Scope](/docs/api/objects/scope/) | Effective scopes of this credential. |
| `workspaces` * | array of [WorkspaceMembership](/docs/api/objects/workspace-membership/) |  |
| `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

```json
{
  "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](/docs/api/me/#who-am-i)