Create Block

POST

/v1/blocks/

This endpoint expects an object.

valuestringRequired

Value of the block.

labelstringRequired

Label 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

descriptionstringOptional

Description of the block.

metadata_map from strings to anyOptional

Metadata of the block.

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.

metadata_map from strings to anyOptional

Metadata of the block.

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

The human-friendly ID of the Block

organization_idstringOptional

The unique identifier of the organization associated with 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	curl -X POST https://app.letta.com/v1/blocks/ \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"value": "value",
6	"label": "label"
7	}'

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