Dynamiq
Datasets

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.

POST
/v1/dataset-items/from-trace

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Identifies the target draft version and the source trace to convert into an item.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/dataset-items/from-trace" \  -H "Content-Type: application/json" \  -d '{    "dataset_id": "8c4c51f1-f6f3-43bc-b65d-7415e8ef22c0",    "dataset_version_id": "04e89766-1052-429f-ac43-0b0a79802db7",    "trace_id": "df570c03-5a03-4cea-8df0-c162d05127ac"  }'
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "dataset_version_id": "04e89766-1052-429f-ac43-0b0a79802db7",
    "data": {}
  }
}
{
  "error": {
    "code": "bad_request",
    "message": "Bad Request",
    "details": {
      "input": "cannot be blank"
    }
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "forbidden",
    "message": "Forbidden"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

Add items to a dataset version

Appends rows to a draft version. Send a JSON body with an `items` array, or upload a `.json` / `.jsonl` file as multipart/form-data in the `file` field. Only draft versions accept new items. When the version has a schema, every item is validated against it; when it does not, the schema is inferred from the first batch of items.

List dataset items

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