agents

List Agent Tools

Changed on

Get tools from an existing agent

get/v1/agents/{agent_id}/tools

Request

  • Base URL
    https://app.letta.com
  • URL
    https://app.letta.com/v1/agents/{agent_id}/tools
  • Auth
    HTTP bearer

Path parameters

agent_idstring required

Query parameters

beforestring nullable

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

limitinteger nullable

Maximum number of tools to return

order'asc' | 'desc'

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

order_by'created_at'

Field to sort by

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"
  }
]

Changes

  • 9b82bb763522Revision changes
    • info

      added the new optional query request parameter after

    • info

      added the new optional query request parameter before

    • info

      added the new optional query request parameter limit

    • info

      added the new optional query request parameter order

    • info

      added the new optional query request parameter order_by