tools

List Tools

Get a list of all tools available to agents belonging to the org of the user

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Query parameters

afterstring or nullOptional
limitinteger or nullOptionalDefaults to 50
namestring or nullOptional
nameslist of strings or nullOptional
Filter by specific tool names
tool_idslist of strings or nullOptional

Filter by specific tool IDs - accepts repeated params or comma-separated values

searchstring or nullOptional

Search tool names (case-insensitive partial match)

tool_typeslist of strings or nullOptional

Filter by tool type(s) - accepts repeated params or comma-separated values

exclude_tool_typeslist of strings or nullOptional

Tool type(s) to exclude - accepts repeated params or comma-separated values

return_only_letta_toolsboolean or nullOptionalDefaults to false

Return only tools with tool_type starting with ‘letta_’

Response

Successful Response
idstring or nullformat: "^tool-[a-fA-F0-9]{8}"

The human-friendly ID of the Tool

tool_typeenum or null
The type of the tool.
descriptionstring or null
The description of the tool.
source_typestring or null
The type of the source code.
namestring or null
The name of the function.
tagslist of strings or null
Metadata tags.
source_codestring or null
The source code of the function.
json_schemamap from strings to any or null
The JSON schema of the function.
args_json_schemamap from strings to any or null
The args JSON schema of the function.
return_char_limitinteger or nullDefaults to 50000
The maximum number of characters in the response.
pip_requirementslist of objects or null
Optional list of pip packages required by this tool.
npm_requirementslist of objects or null
Optional list of npm packages required by this tool.
default_requires_approvalboolean or null
Default value for whether or not executing this tool requires approval.
created_by_idstring or null
The id of the user that made this Tool.
last_updated_by_idstring or null
The id of the user that made this Tool.
metadata_map from strings to any or null
A dictionary of additional metadata for the tool.

Errors