Dynamiq
Datasets

List dataset items

Lists the items of a dataset version. The dataset_version_id query parameter is required.

GET
/v1/dataset-items

Authorization

personalAccessToken
AuthorizationBearer <token>

Personal Access Token of a Dynamiq user — the only credential accepted by the management API (api.*). Prefix dyn_pat_ (legacy uak_ tokens still authenticate). Send as Authorization: Bearer <token>.

In: header

Query Parameters

dataset_version_id*string

Dataset version UUID to list items for.

page?integer

Page number (1-based).

page_size?integer

Number of items per page. Values below the minimum or above the maximum are clamped to the nearest bound.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/dataset-items?dataset_version_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "dataset_version_id": "04e89766-1052-429f-ac43-0b0a79802db7",
      "data": {}
    }
  ],
  "pagination": {
    "page": 0,
    "page_size": 0,
    "page_count": 0,
    "total_count": 0
  }
}
{
  "error": {
    "code": "bad_request",
    "message": "Bad Request",
    "details": {
      "input": "cannot be blank"
    }
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

Add a dataset item from a trace

Builds a new dataset item from a captured trace and appends it to a draft version — a fast way to turn a real, observed run into an evaluation row. The body identifies the target `dataset_id` and `dataset_version_id` and the source `trace_id`.

Get a dataset item

Returns a single dataset item and its `data` fields.