identities
identities

Retrieve Identity

get/v1/identities/{identity_id}

Request

  • Base URL
    https://app.letta.com
  • URL
    https://app.letta.com/v1/identities/{identity_id}
  • Auth
    HTTP bearer

Path parameters

identity_idstring required

Response

Successful Response

idstring

The human-friendly ID of the Identity

identifier_keystring required

External, user-generated identifier key of the identity.

namestring required

The name of the identity.

identity_type'org' | 'user' | 'other' required

Enum to represent the type of the identity.

project_idstring nullable

The project id of the identity, if applicable.

agent_idsstring[] required

The IDs of the agents associated with the identity.

block_idsstring[] required

The IDs of the blocks associated with the identity.

Example response

{
  "id": "identity-123e4567-e89b-12d3-a456-426614174000"
}

Changes

No recorded changes to this operation across all 36 revisions of this API.