Tools

List tools for an agent

List every tool attached to the given agent. This is the inverse of listing agents for a tool: it returns the full tool records (url, method, parameters, etc.) that the agent can invoke during a conversation. Each tool includes a link_id identifying its link to this agent, which you pass to DELETE /api/ext/tool/unlink/{link_id} to detach it. Identified by the agent_id path parameter and authenticated with your API key.

GET

https://api.nabrah.ai/api/ext/tool/agent/{agent_id}

curl --request GET \
  --url 'https://api.nabrah.ai/api/ext/tool/agent/<agent_id>' \
  --header 'X-API-Key: <your-api-key>'

[
  {
    "name": "string",
    "description": "string",
    "url": "string",
    "method": "GET",
    "id": "00000000-0000-4000-8000-000000000000",
    "project_id": "00000000-0000-4000-8000-000000000000",
    "created_at": "2026-01-15T12:00:00.000Z",
    "updated_at": "2026-01-15T12:00:00.000Z",
    "timeout_seconds": 5,
    "parameters": [
      {
        "name": "string",
        "location": "query",
        "parameter_type": "constant",
        "data_type": "string",
        "description": "string",
        "tool_id": "00000000-0000-4000-8000-000000000000",
        "required": false,
        "value": "string",
        "default_value": "string"
      }
    ],
    "link_id": "00000000-0000-4000-8000-000000000000"
  }
]

Response fields

Linked tool record

Each item is a full tool record. id is the tool_id; parameters is the full parameter list; timeout_seconds and method describe the webhook call. link_id identifies the link between this tool and the agent — pass it to the unlink endpoint to detach the tool from this agent.

idnamedescriptionurlmethodproject_idtimeout_secondsparameterslink_id

Authorization

X-API-Keystringheaderrequired

Your workspace API key. Create one in the dashboard under API keys.

Path parameters

agent_idstringrequired

The ID of the agent whose tools you want to list.

Obtain it from GET /api/ext/agent (the id field).

Response

200

Successful Response

application/json

422

Validation Error

application/json