Skip to main content

Update data collection

Endpoint: PUT /data-collections/{data_collection_id}

Description Updates name, dataset_ids, and/or org_id. All body fields are optional.

Parameters

  • Path: data_collection_id — integer.
  • Body — application/json:
{
  "name": "string | null",
  "dataset_ids": "integer[] | null",
  "org_id": "integer | null"
}

Error responses

  • 401 — Authentication failed.
  • 422 — Invalid body.
  • 404 — Collection not found.
  • 400 — Empty name; duplicate name; invalid dataset_ids (same rules as create).
  • 500 — Server error.

Responses

  • 200 — updated collection object with the same JSON shape as one element of items from Get data collections.

Example response (200)

{
  "id": 14,
  "user": { "id": 7, "email": "analyst@acme.com" },
  "name": "Renamed bundle",
  "org_id": null,
  "datasets": [
    {
      "id": 1,
      "name": "Support QA - March",
      "user": { "id": 7, "email": "analyst@acme.com" },
      "org_id": null
    },
    {
      "id": 2,
      "name": "Support QA - April",
      "user": { "id": 7, "email": "analyst@acme.com" },
      "org_id": null
    },
    {
      "id": 3,
      "name": "Support QA - May",
      "user": { "id": 7, "email": "analyst@acme.com" },
      "org_id": null
    }
  ],
  "runs": [],
  "created_at": "2026-04-01T09:20:00Z",
  "updated_at": "2026-04-01T09:30:00Z"
}

curl

curl -X PUT "https://api.aegisevals.ai/api/v1/data-collections/1" \
  -H "Authorization: Bearer sk_00000000000000000000000000000000" \
  -H "Content-Type: application/json" \
  -d '{"name":"Renamed bundle","dataset_ids":[1,2,3]}'