---
title: "Read the authenticated agent identity"
method: GET
path: "/agent/identity"
---

# Read the authenticated agent identity

`GET /agent/identity`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/agent/identity`
- Auth: HTTP bearer

Returns the server-resolved BAMF account identity, effective creator-space count, and verified saved default creator space. Email and display name are returned when available. A sole accessible space may be returned separately as a recommendation when no saved default exists. Query, body, identity, scope, and workspace selectors are not accepted.

## Response `200`

Authenticated actor identity positive allowlist

- AgentIdentityOperationResponse
  - `schema` 'bamf.operation-result/v1', required
  - `operation_ref` 'bamf.agent.identity.read/v1', required
  - `data` AgentIdentity, required
    - `user_id` string, required
    - `key_type` 'session' | 'user' | 'creator', required
    - `email` string, nullable, required: Authenticated BAMF account email when available.
    - `display_name` string, nullable, required: Authenticated BAMF account display name when available.
    - `creator_id` string, nullable, required
    - `creator_space` AgentIdentityCreatorSpace, required
      - `id` string, required
      - `creator_id` string, required
      - `name` string, nullable, required
    - `default_creator_space` AgentIdentityCreatorSpace, required
      - `id` string, required
      - `creator_id` string, required
      - `name` string, nullable, required
    - `recommended_creator_space` AgentIdentityCreatorSpace, required
      - `id` string, required
      - `creator_id` string, required
      - `name` string, nullable, required
    - `accessible_creator_space_count` integer, required
    - `scopes` string[], required
  - `receipt` unknown, required

## Other responses

- `400`: Client authority selector rejected
- `401`: Missing or invalid bearer token
- `500`: Identity resolution temporarily unavailable

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/2337a0710c2e?raw)