# Agents API

Create and configure voice agents, and choose which analysis groups run after their calls.

- [Create agent](https://www.nabrah.ai/en/docs/api-reference/agents/create-agent.md) `POST /api/ext/agent`: Creates a new agent in the project tied to your API key and returns the full agent configuration, including the generated agent_id.
- [List agents](https://www.nabrah.ai/en/docs/api-reference/agents/list-agents.md) `GET /api/ext/agent`: Returns a brief listing of every agent in the workspace tied to your API key.
- [Get agent](https://www.nabrah.ai/en/docs/api-reference/agents/get-agent.md) `GET /api/ext/agent/{agent_id}`: Returns the complete configuration for a single agent identified by agent_id, including persona, voice/language settings, behavioral toggles, dynamic variables, webhook callbacks, and the fully expanded lists of linked tools, system_tools, and analysis_groups.
- [Update agent](https://www.nabrah.ai/en/docs/api-reference/agents/update-agent.md) `PUT /api/ext/agent/{agent_id}`: Updates the agent identified by agent_id and returns the full updated configuration.
- [Delete agent](https://www.nabrah.ai/en/docs/api-reference/agents/delete-agent.md) `DELETE /api/ext/agent/{agent_id}`: Permanently deletes the agent identified by agent_id.
- [Link analysis groups to an agent](https://www.nabrah.ai/en/docs/api-reference/agents/link-analysis-groups-to-an-agent.md) `POST /api/ext/agent/{agent_id}/analysis_groups`: Links one or more existing analysis groups to the agent identified by agent_id in a single call.
- [List analysis groups for an agent](https://www.nabrah.ai/en/docs/api-reference/agents/list-analysis-groups-for-an-agent.md) `GET /api/ext/agent/{agent_id}/analysis_groups`: Lists all analysis groups currently linked to the agent identified by agent_id.