# Analysis groups API

Define the data extracted from every call, and link analysis groups to agents.

- [Create analysis group](https://www.nabrah.ai/en/docs/api-reference/analysis-groups/create-analysis-group.md) `POST /api/ext/analysis`: Creates a new analysis group together with its data collections and returns the full group, including the generated id.
- [List analysis groups](https://www.nabrah.ai/en/docs/api-reference/analysis-groups/list-analysis-groups.md) `GET /api/ext/analysis`: Returns a brief listing of every analysis group in the workspace tied to your API key.
- [Get analysis group](https://www.nabrah.ai/en/docs/api-reference/analysis-groups/get-analysis-group.md) `GET /api/ext/analysis/{analysis_group_id}`: Returns the full definition of a single analysis group identified by analysis_group_id, including all of its data_collections (each with name, type, description, and constraints).
- [Update analysis group](https://www.nabrah.ai/en/docs/api-reference/analysis-groups/update-analysis-group.md) `PUT /api/ext/analysis/{analysis_group_id}`: Updates the analysis group identified by analysis_group_id, replacing its name and data collections with the values provided, and returns the full updated group.
- [Delete analysis group](https://www.nabrah.ai/en/docs/api-reference/analysis-groups/delete-analysis-group.md) `DELETE /api/ext/analysis/{analysis_group_id}`: Permanently deletes the analysis group identified by analysis_group_id along with all its data collections and any links to agents.
- [Link an agent to an analysis group](https://www.nabrah.ai/en/docs/api-reference/analysis-groups/link-an-agent-to-an-analysis-group.md) `POST /api/ext/analysis/{analysis_group_id}/agent`: Links a single agent to the analysis group identified by analysis_group_id and returns the new link_id.
- [Link agents to an analysis group](https://www.nabrah.ai/en/docs/api-reference/analysis-groups/link-agents-to-an-analysis-group.md) `POST /api/ext/analysis/{analysis_group_id}/agents`: Links multiple agents to the analysis group identified by analysis_group_id in a single call and returns one link_id per created link.
- [List agents for an analysis group](https://www.nabrah.ai/en/docs/api-reference/analysis-groups/list-agents-for-an-analysis-group.md) `GET /api/ext/analysis/{analysis_group_id}/agents`: Lists all agents currently linked to the analysis group identified by analysis_group_id.
- [Unlink an analysis group from an agent](https://www.nabrah.ai/en/docs/api-reference/analysis-groups/unlink-an-analysis-group-from-an-agent.md) `DELETE /api/ext/analysis/link/{link_id}`: Removes a single agent↔analysis-group association identified by link_id.