Upsert Tool — Letta | Documentation

Create or update a tool

Request

This endpoint expects an object.

source_codestringRequired

The source code of the function.

namestringOptional

The name of the function (auto-generated from source_code if not provided).

descriptionstringOptional

The description of the tool.

tagslist of stringsOptional

Metadata tags.

modulestringOptional

The source code of the function.

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.

Response

Successful Response

source_codestring

The source code of the function.

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

The human-friendly ID of the Tool

descriptionstringOptional

The description of the tool.

source_typestringOptional

The type of the source code.

modulestringOptional

The module of the function.

organization_idstringOptional

The unique identifier of the organization associated with the tool.

namestringOptional

The name of the function.

tagslist of stringsOptional

Metadata tags.

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 PUT 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	"source_code": "source_code",
3	"id": "tool-123e4567-e89b-12d3-a456-426614174000",
4	"description": "description",
5	"source_type": "source_type",
6	"module": "module",
7	"organization_id": "organization_id",
8	"name": "name",
9	"tags": [
10	"tags"
11	],
12	"json_schema": {
13	"key": "value"
14	},
15	"return_char_limit": 1,
16	"created_by_id": "created_by_id",
17	"last_updated_by_id": "last_updated_by_id"
18	}

Request

Response

Errors