Retrieve Identity

identity_idstringRequired

Successful Response

identifier_keystring

External, user-generated identifier key of the identity.

namestring

The name of the identity.

identity_typeenum

Allowed values: orguserother

The type of the identity.

agent_idslist of strings

The IDs of the agents associated with the identity.

idstringOptionalformat: "^identity-[a-fA-F0-9]{8}"

The human-friendly ID of the Identity

project_idstringOptional

The project id of the identity, if applicable.

propertieslist of objectsOptional

List of properties associated with the identity

1	{
2	"identifier_key": "identifier_key",
3	"name": "name",
4	"identity_type": "org",
5	"agent_ids": [
6	"agent_ids"
7	],
8	"id": "identity-123e4567-e89b-12d3-a456-426614174000",
9	"project_id": "project_id",
10	"properties": [
11	{
12	"key": "key",
13	"value": "value",
14	"type": "string"
15	}
16	]
17	}

1	curl https://app.letta.com/v1/identities/identity_id \
2	-H "Authorization: Bearer <token>"