tools

List Tools

Get a list of all tools available to agents.

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Query parameters

beforestring or nullOptional
Tool ID cursor for pagination. Returns tools that come before this tool ID in the specified sort order
afterstring or nullOptional
Tool ID cursor for pagination. Returns tools that come after this tool ID in the specified sort order
limitinteger or nullOptionalDefaults to 50
Maximum number of tools to return
orderenumOptionalDefaults to desc
Sort order for tools by creation time. 'asc' for oldest first, 'desc' for newest first
Allowed values:
order_by"created_at"OptionalDefaults to created_at
Field to sort by
namestring or nullOptional
Filter by single tool name
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