Sign in

v36

latestOpenAPI 3.1.0raw.githubusercontent.com2025-10-091882241.2 MB
tools

List Tools

Get a list of all tools available to agents.

get/v1/tools/

Query parameters

beforestring nullable

Tool ID cursor for pagination. Returns tools that come before this tool ID in the specified sort order

Tool ID cursor for pagination. Returns tools that come before this tool ID in the specified sort order

afterstring nullable

Tool ID cursor for pagination. Returns tools that come after this tool ID in the specified sort order

Tool ID cursor for pagination. Returns tools that come after this tool ID in the specified sort order

limitinteger nullable

Maximum number of tools to return

Maximum number of tools to return

order'asc' | 'desc'

Sort order for tools by creation time. 'asc' for oldest first, 'desc' for newest first

Sort order for tools by creation time. 'asc' for oldest first, 'desc' for newest first

order_by'created_at'

Field to sort by

Field to sort by

namestring nullable

Filter by single tool name

Filter by single tool name

namesstring[] nullable

Filter by specific tool names

Filter by specific tool names

tool_idsstring[] nullable

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

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

searchstring nullable

Search tool names (case-insensitive partial match)

Search tool names (case-insensitive partial match)

tool_typesstring[] nullable

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

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

exclude_tool_typesstring[] nullable

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

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

return_only_letta_toolsboolean nullable

Return only tools with tool_type starting with 'letta_'

Return only tools with tool_type starting with 'letta_'

Response

Successful Response

idstring

The human-friendly ID of the Tool

tool_type'custom' | 'letta_core' | 'letta_memory_core' | 'letta_multi_agent_core' | 'letta_sleeptime_core' | 'letta_voice_sleeptime_core' | 'letta_builtin' | 'letta_files_core' | 'external_langchain' | 'external_composio' | 'external_mcp'
descriptionstring nullable

The description of the tool.

source_typestring nullable

The type of the source code.

namestring nullable

The name of the function.

tagsstring[]

Metadata tags.

source_codestring nullable

The source code of the function.

json_schemaobject nullable

The JSON schema of the function.

args_json_schemaobject nullable

The args JSON schema of the function.

return_char_limitinteger

The maximum number of characters in the response.

default_requires_approvalboolean nullable

Default value for whether or not executing this tool requires approval.

created_by_idstring nullable

The id of the user that made this Tool.

last_updated_by_idstring nullable

The id of the user that made this Tool.

metadata_object nullable

A dictionary of additional metadata for the tool.

Example response

[
  {
    "id": "tool-123e4567-e89b-12d3-a456-426614174000"
  }
]