Run Tool From Source

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.

argsobjectRequired

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.

args_json_schemaobjectOptional

The args JSON schema of the function.

json_schemaobjectOptional

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

pip_requirementslist of objectsOptional

Optional list of pip packages required by this tool.

Successful Response

idstring

datestringformat: "date-time"

tool_returnstring

statusenum

Allowed values:

tool_call_idstring

namestring or null

message_type"tool_return_message" or nullDefaults to tool_return_message

The type of the message.

otidstring or null

sender_idstring or null

step_idstring or null

stdoutlist of strings or null

stderrlist of strings or null

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

1	{
2	"id": "foo",
3	"date": "foo",
4	"tool_return": "foo",
5	"status": "success",
6	"tool_call_id": "foo",
7	"name": "foo",
8	"message_type": "tool_return_message",
9	"otid": "foo",
10	"sender_id": "foo",
11	"step_id": "foo",
12	"stdout": [
13	"foo"
14	],
15	"stderr": [
16	"foo"
17	]
18	}