Identity

Operations tagged Identity in the public API.

/v1/me

Identify the calling key

Returns the account the key belongs to and the key's own record — its id, mode, granted scopes, and last use. Needs no scope, so it is the safest way to verify a key works and to discover the id that `DELETE /v1/api_keys/{id}` will accept for self-revocation.

Status	Description
`200`	Success.
`401`	Unauthenticated
`403`	The API key is missing a required scope.
`429`	Rate limited. Honour the Retry-After header before retrying.

Example 200 response

json

{
  "object": "account",
  "id": 1,
  "name": "Acme Support",
  "key": {
    "object": "api_key",
    "id": 1,
    "name": "v1-test",
    "mode": "live",
    "key_id": "iltP3TBMKG4RI6nf",
    "masked": "agy_live_iltP3TBMKG4RI6nf_••••Lydk",
    "last_four": "Lydk",
    "scopes": [
      "chatbots:read",
      "chatbots:write",
      "knowledge:read",
      "knowledge:write",
      "crawlers:read",
      "crawlers:write",
      "conversations:read",
      "conversations:write",
      "chat:send",
      "actions:read",
      "actions:write",
      "channels:read",
      "channels:write",
      "customers:read",
      "customers:write",
      "widget:read",
      "widget:write",
      "search:read",
      "analytics:read",
      "billing:read",
      "webhooks:read",
      "webhooks:write",
      "keys:read",
      "keys:write",
      "files:read",
      "files:write",
      "profile:read",
      "profile:write"
    ],
    "rate_limit_per_minute": null,
    "allowed_ips": null,
    "expires_at": null,
    "last_used_at": null,
    "last_used_ip": null,
    "revoked_at": null,
    "rotation_grace_until": null,
    "created_at": "2026-01-01T00:00:00+00:00"
  }
}

curl

curl -X GET https://api.agentency.com/v1/me \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"