---
title: "GET /api/v1/{context_id}/me"
method: GET
path: "/api/v1/{context_id}/me"
---

# GET /api/v1/{context_id}/me

`GET /api/v1/{context_id}/me`

Return the calling token's resolved identity, the principal's grants, the key's attenuating grants (if any), and the effective per-verb grants. Self-only; never requires `grant:manage`.

## Path parameters

- `context_id` string, required

## Response `200`

- WhoamiJson — The `GET /{ctx}/me` response. Reflects only the *calling* token's resolved identity — no principal lookup gated by `grant:manage`.
  - `delegatedPrincipalId` string, nullable — When the token is delegating (`X-Spectron-On-Behalf-Of`), the target principal id; absent for non-delegated calls.
  - `displayName` string, required — Human-readable display name.
  - `effectiveGrants` Grants, required — Per-verb scope pattern map. Keys are grant verbs in `<noun>:<verb>` form (`memory:read`, `memory:write`, `memory:forget`, `scope:read`, `scope:create`, `scope:delete`, `grant:manage`); values are arrays of scope patterns.
  - `grants` Grants, required — Per-verb scope pattern map. Keys are grant verbs in `<noun>:<verb>` form (`memory:read`, `memory:write`, `memory:forget`, `scope:read`, `scope:create`, `scope:delete`, `grant:manage`); values are arrays of scope patterns.
  - `kind` string, required — Principal kind (`human`/`agent`/`service`/`unknown`).
  - `principalId` string, required — The token's principal id. Always a bound principal — an unbound key is rejected at authentication, so this is never a bare key id.
  - `tokenGrants` Grants — Per-verb scope pattern map. Keys are grant verbs in `<noun>:<verb>` form (`memory:read`, `memory:write`, `memory:forget`, `scope:read`, `scope:create`, `scope:delete`, `grant:manage`); values are arrays of scope patterns.

## Other responses

- `401` — Unauthorized
- `422` — Invalid context id

---

[API](https://skmtc.net/surrealdb/apis/spectron.md) · [All operations](https://skmtc.net/surrealdb/apis/spectron/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surrealdb/spectron/versions/52b41ab517b6/schema)