API referenceUpdate analysis group

Analysis groups

Update analysis group

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. Supply the complete intended set of data_collections — this defines the group's collections going forward. Existing agent links to the group are preserved.

PUT

https://api.nabrah.ai/api/ext/analysis/{analysis_group_id}

curl --request PUT \
  --url 'https://api.nabrah.ai/api/ext/analysis/<analysis_group_id>' \
  --header 'X-API-Key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Support Call Analysis (v2)",
  "data_collections": [
    {
      "name": "resolved",
      "type": "boolean",
      "description": "Whether the caller'\''s issue was resolved during the call.",
      "constraints": {}
    },
    {
      "name": "follow_up_needed",
      "type": "boolean",
      "description": "Whether a follow-up call or ticket is required.",
      "constraints": {}
    }
  ]
}'

{
  "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",
  "data_collections": [
    {
      "name": "string",
      "type": "string",
      "id": "00000000-0000-4000-8000-000000000000",
      "analysis_group_id": "00000000-0000-4000-8000-000000000000",
      "description": "string",
      "constraints": {}
    }
  ]
}

Where analysis_group_id comes from

Discovering the ID

List groups with GET /api/ext/analysis, or use the id returned by POST /api/ext/analysis.

Body fields

Same shape as create

The body mirrors Create Analysis Group: a name and a data_collections array of { name, type, description, constraints }.

namedata_collections

Authorization

X-API-Keystringheaderrequired

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

Path parameters

analysis_group_idstringrequired

UUID of the analysis group to update.

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

Body

application/json

Rename the group and redefine its data collections.

Example

{
  "name": "Support Call Analysis (v2)",
  "data_collections": [
    {
      "name": "resolved",
      "type": "boolean",
      "description": "Whether the caller's issue was resolved during the call.",
      "constraints": {}
    },
    {
      "name": "follow_up_needed",
      "type": "boolean",
      "description": "Whether a follow-up call or ticket is required.",
      "constraints": {}
    }
  ]
}

Response

200

Successful Response

application/json

422

Validation Error

application/json

API referenceUpdate analysis group

Analysis groups

Update analysis group

PUT

https://api.nabrah.ai/api/ext/analysis/{analysis_group_id}

Update analysis group

curl --request PUT \
  --url 'https://api.nabrah.ai/api/ext/analysis/<analysis_group_id>' \
  --header 'X-API-Key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Support Call Analysis (v2)",
  "data_collections": [
    {
      "name": "resolved",
      "type": "boolean",
      "description": "Whether the caller'\''s issue was resolved during the call.",
      "constraints": {}
    },
    {
      "name": "follow_up_needed",
      "type": "boolean",
      "description": "Whether a follow-up call or ticket is required.",
      "constraints": {}
    }
  ]
}'

{
  "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",
  "data_collections": [
    {
      "name": "string",
      "type": "string",
      "id": "00000000-0000-4000-8000-000000000000",
      "analysis_group_id": "00000000-0000-4000-8000-000000000000",
      "description": "string",
      "constraints": {}
    }
  ]
}

Where analysis_group_id comes from

Discovering the ID

List groups with GET /api/ext/analysis, or use the id returned by POST /api/ext/analysis.

Body fields

Same shape as create

The body mirrors Create Analysis Group: a name and a data_collections array of { name, type, description, constraints }.

namedata_collections

Authorization

X-API-Keystringheaderrequired

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

Path parameters

analysis_group_idstringrequired

UUID of the analysis group to update.

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

Body

application/json

Rename the group and redefine its data collections.

Example

{
  "name": "Support Call Analysis (v2)",
  "data_collections": [
    {
      "name": "resolved",
      "type": "boolean",
      "description": "Whether the caller's issue was resolved during the call.",
      "constraints": {}
    },
    {
      "name": "follow_up_needed",
      "type": "boolean",
      "description": "Whether a follow-up call or ticket is required.",
      "constraints": {}
    }
  ]
}

Response

200

Successful Response

application/json

422

Validation Error

application/json