v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

List agent tools

Returns all tools for the authenticated app, optionally filtered by agent or tool kind. Both explicitly created tools and tools derived from connected integrations (installation-sourced tools) are included in the response.

Installation-sourced tools appear with source: "installation" and status: "active". They are synthesized at request time from connected integrations and do not have a persistent tool ID of the atl_... form; their id is a composite of the installation ID and server tool type.

Use the agent filter to retrieve tools for a specific agent. Supplying an agent ID that does not belong to the authenticated app returns 404. Requires app scope.

get/api/v1/agents/{agent}/agent_tools

Path parameters

agentstring required

Filter results to tools belonging to this agent (agt_...). Omit to return tools across all agents in the app.

Query parameters

kindstring

Filter by tool kind. One of "builtin" or "custom". Omit to return tools of all kinds.

Response

Successful response

Example response

{
  "data": [
    {
      "agent": "agi_0aBcDeFgHiJkLmNoPqRsTu",
      "app": "dap_0aBcDeFgHiJkLmNoPqRsTu",
      "async": true,
      "builtin_tool_config": {},
      "builtin_tool_key": "string",
      "config": "cfg_0aBcDeFgHiJkLmNoPqRsTu",
      "created_at": "2024-01-01T00:00:00Z",
      "description": "An example description.",
      "handler_type": "http",
      "id": "atl_0aBcDeFgHiJkLmNoPqRsTu",
      "instruction": "string",
      "kind": "builtin",
      "last_applied_template_config": "cfg_0aBcDeFgHiJkLmNoPqRsTu",
      "lookup_key": "string",
      "metadata": {
        "key": "value"
      },
      "name": "Example Name",
      "name_prefix": "string",
      "parameters": {},
      "parameters_config": "cfg_0aBcDeFgHiJkLmNoPqRsTu",
      "status": "active",
      "updated_at": "2024-01-01T00:00:00Z"
    }
  ]
}