Agents

List analysis groups for an agent

Lists all analysis groups currently linked to the agent identified by agent_id. Agents and analysis groups have a many-to-many relationship; this endpoint shows that relationship from the agent's side. Crucially, each returned item includes the link_id for the agent↔analysis-group association — you need that link_id to unlink them later via DELETE /api/ext/analysis/link/{link_id}.

GET

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

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

{
  "analysis_groups": [
    {
      "name": "string",
      "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",
      "link_id": "00000000-0000-4000-8000-000000000000"
    }
  ]
}

Where agent_id comes from

Discovering the ID

Use GET /api/ext/agent to list agents, or the agent_id returned by POST /api/ext/agent.

Response shape

Returns an object with an analysis_groups array.

The link_id matters

Each analysis group in the array carries a link_id representing this specific agent↔group link. Save it to unlink later. The id field is the analysis group's own ID (usable with the /api/ext/analysis endpoints).

nameidproject_idcreated_atupdated_atlink_id

Authorization

X-API-Keystringheaderrequired

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

Path parameters

agent_idstringrequired

UUID of the agent whose linked analysis groups you want to list.

Get this from GET /api/ext/agent or from the create-agent response (POST /api/ext/agent).

Response

200

Successful Response

application/json

422

Validation Error

application/json