Run Tool From Source

POST

/v1/tools/run

Attempt to build a tool from source, then run it on the provided arguments

This endpoint expects an object.

source_codestringRequired

The source code of the function.

argsmap from strings to anyRequired

The arguments to pass to the tool.

env_varsmap from strings to stringsOptional

The environment variables to pass to the tool.

namestringOptional

The name of the tool to run.

source_typestringOptional

The type of the source code.

Successful Response

idstring

datedatetime

message_type"tool_return_message"

tool_returnstring

statusenum

Allowed values: successerror

tool_call_idstring

stdoutlist of stringsOptional

stderrlist of stringsOptional

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

1	{
2	"id": "id",
3	"date": "2024-01-15T09:30:00Z",
4	"message_type": "tool_return_message",
5	"tool_return": "tool_return",
6	"status": "success",
7	"tool_call_id": "tool_call_id",
8	"stdout": [
9	"stdout"
10	],
11	"stderr": [
12	"stderr"
13	]
14	}