Tools

List agents for a tool

List every agent that the given tool is linked to. Tools and agents form a many-to-many relationship: one tool can be attached to multiple agents. Each result includes the agent plus the link_id that joins it to this tool, which you pass to DELETE /api/ext/tool/unlink/{link_id} to detach them. Identified by the tool_id path parameter and authenticated with your API key.

GET

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

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

[
  {
    "id": "00000000-0000-4000-8000-000000000000",
    "name": "string",
    "link_id": "00000000-0000-4000-8000-000000000000",
    "created_at": "2026-01-15T12:00:00.000Z",
    "updated_at": "2026-01-15T12:00:00.000Z"
  }
]

Response fields

Linked agent

id is the agent_id. link_id is the identifier of the tool-agent link; use it to unlink via DELETE /api/ext/tool/unlink/{link_id}. created_at and updated_at reflect when the link was made or last changed.

idnamelink_idcreated_atupdated_at

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 whose linked agents you want to list.

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