Create Identity

X-ProjectstringOptional

This endpoint expects an object.

identifier_keystringRequired

External, user-generated identifier key of the identity.

namestringRequired

The name of the identity.

identity_typeenumRequired

Allowed values: orguserother

The type of the identity.

project_idstringOptional

The project id of the identity, if applicable.

agent_idslist of stringsOptional

The agent ids that are associated with the identity.

propertieslist of objectsOptional

List of properties associated with the identity.

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	curl -X POST https://app.letta.com/v1/identities/ \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"identifier_key": "identifier_key",
6	"name": "name",
7	"identity_type": "org"
8	}'

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	}