Agents
List agents
Returns a brief listing of every agent in the workspace tied to your API key. Agents are the voice/chat AI configurations that define how a call behaves (persona, goal, voice, language, linked tools and analysis groups). Use this endpoint as the entry point for discovering agents and obtaining the agent_id values that the per-agent endpoints (get, update, delete, link analysis groups) require. The response is a flat array of compact summaries; call GET /api/ext/agent/{agent_id} to retrieve the full configuration of any single agent.
curl --request GET \
--url 'https://api.nabrah.ai/api/ext/agent' \
--header 'X-API-Key: <your-api-key>'[
{
"agent_id": "00000000-0000-4000-8000-000000000000",
"name": "string",
"created_at": "2026-01-15T12:00:00.000Z",
"last_update": "2026-01-15T12:00:00.000Z",
"created_by_email": "string",
"enable_ticket_creation": false
}
]Authentication & scope
These endpoints are scoped to a single project by your API key.
Send your Web API key (prefixed nb_) in the X-API-Key header on every request. Keys are generated in the dashboard under the Developers tab and are bound to exactly one project/workspace, so no project_id is passed — the project is derived from the key. Validate a key with GET /api/ext/test.
Response shape
The body is a JSON array of AgentBrief objects (not a wrapped/paginated object).
Each item contains the agent identifier and lightweight metadata. There is no server-side pagination on this endpoint — all agents in the project are returned in one array.
agent_idnamecreated_atlast_updatecreated_by_emailenable_ticket_creationUse the agent_id from this list anywhere an agent ID is required.
Authorization
X-API-KeystringheaderrequiredYour workspace API key. Create one in the dashboard under API keys.
Response
Successful Response
application/json