Tools

Get tool

Retrieve the full record for a single tool by its id, including its url, method, timeout, and the complete list of parameters with their tool_id back-reference. Use this to inspect a tool's exact configuration before updating it or linking it to an agent. Authenticated with your API key.

GET

https://api.nabrah.ai/api/ext/tool/{tool_id}

Get tool

curl --request GET \
  --url 'https://api.nabrah.ai/api/ext/tool/<tool_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

Full tool record

Includes id (the tool_id), project_id, timestamps, the webhook url and method, timeout_seconds, and the full parameters array. Each parameter carries a tool_id back-reference to this tool. link_id is populated when the tool is being viewed in the context of a specific agent link.

idnamedescriptionurlmethodproject_idtimeout_secondsparameterslink_id

Authorization

X-API-Keystringheaderrequired

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

Path parameters

tool_idstringrequired

The ID of the tool to fetch.

Obtain it from GET /api/ext/tool (the id field) or from the response of POST /api/ext/tool.

Response

200

Successful Response

application/json

422

Validation Error

application/json