Create Tool

POST

/v1/tools/

Create a new tool

This endpoint expects an object.

source_codestringRequired

The source code of the function.

descriptionstringOptional

The description of the tool.

tagslist of stringsOptional

Metadata tags.

source_typestringOptionalDefaults to python

The source type of the function.

json_schemamap from strings to anyOptional

The JSON schema of the function (auto-generated from source_code if not provided)

return_char_limitintegerOptionalDefaults to 6000

The maximum number of characters in the response.

Successful Response

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

The human-friendly ID of the Tool

tool_typeenumOptional

Allowed values: customletta_coreletta_memory_coreletta_multi_agent_coreexternal_composio

The type of the tool.

descriptionstringOptional

The description of the tool.

source_typestringOptional

The type of the source code.

namestringOptional

The name of the function.

tagslist of stringsOptional

Metadata tags.

source_codestringOptional

The source code of the function.

json_schemamap from strings to anyOptional

The JSON schema of the function.

return_char_limitintegerOptionalDefaults to 6000

The maximum number of characters in the response.

created_by_idstringOptional

The id of the user that made this Tool.

last_updated_by_idstringOptional

The id of the user that made this Tool.

1	curl -X POST https://app.letta.com/v1/tools/ \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"source_code": "source_code"
6	}'

1	{
2	"id": "tool-123e4567-e89b-12d3-a456-426614174000",
3	"tool_type": "custom",
4	"description": "description",
5	"source_type": "source_type",
6	"name": "name",
7	"tags": [
8	"tags"
9	],
10	"source_code": "source_code",
11	"json_schema": {
12	"key": "value"
13	},
14	"return_char_limit": 1,
15	"created_by_id": "created_by_id",
16	"last_updated_by_id": "last_updated_by_id"
17	}