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.
Authorization
personalAccessToken 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
Path Parameters
Dataset version UUID.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/dataset-versions/497f6eca-6276-4993-bfeb-53cbbbba6f08/items" \ -H "Content-Type: application/json" \ -d '{ "items": [ {} ] }'{
"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"
}
}Update a dataset version schema
Incrementally edits a dataset version's item schema by adding and/or removing fields. Each `add` entry defines a field and its schema; each `delete` entry names a field to remove and, when `delete_from_items` is true, also strips that field from every existing item. The resulting schema must remain compatible with all existing items.
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`.