Skip to main content

Create data collection

Endpoint: POST /data-collections

Description Creates a data collection. Optional dataset_ids attaches your non-proprietary datasets that are not already in another collection; linked runs for those datasets move to this collection too.

Parameters

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

Error responses

  • 401 — Authentication failed.
  • 422 — Invalid body.
  • 400 — Empty name; duplicate name for your account; dataset_ids invalid, proprietary, or already assigned elsewhere.
  • 404 — Referenced dataset ids not found (or treated as invalid for this operation).
  • 500 — Server error creating the collection.

Responses

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

Example response (201)

{
  "id": 14,
  "user": { "id": 7, "email": "analyst@acme.com" },
  "name": "My 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
    }
  ],
  "runs": [],
  "created_at": "2026-04-01T09:20:00Z",
  "updated_at": "2026-04-01T09:20:00Z"
}

curl

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