List Blocks

labelstringOptional

Labels to include (e.g. human, persona)

templates_onlybooleanOptionalDefaults to false

Whether to include only templates

namestringOptional

Name of the block

identity_idstringOptional

Search agents by identifier id

identifier_keysstringOptional

Search agents by identifier keys

Successful Response

valuestring

Value of the block.

limitintegerOptionalDefaults to 5000

Character limit of the block.

namestringOptional

Name of the block if it is a template.

is_templatebooleanOptionalDefaults to false

Whether the block is a template (e.g. saved human/persona options).

labelstringOptional

Label of the block (e.g. ‘human’, ‘persona’) in the context window.

descriptionstringOptional

Description of the block.

metadatamap from strings to anyOptional

Metadata of the block.

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

The human-friendly ID of the Block

created_by_idstringOptional

The id of the user that made this Block.

last_updated_by_idstringOptional

The id of the user that last updated this Block.

1	from letta_client import Letta
2
3	client = Letta(
4	token="YOUR_TOKEN",
5	)
6	client.blocks.list()

1	[
2	{
3	"value": "value",
4	"limit": 1,
5	"name": "name",
6	"is_template": true,
7	"label": "label",
8	"description": "description",
9	"metadata": {
10	"key": "value"
11	},
12	"id": "block-123e4567-e89b-12d3-a456-426614174000",
13	"created_by_id": "created_by_id",
14	"last_updated_by_id": "last_updated_by_id"
15	}
16	]