Datasets
Delete a dataset version
Deletes a draft version and all of its items. Released versions cannot be deleted and return 400.
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
Path Parameters
dataset_version_id*string
Dataset version UUID.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/dataset-versions/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"message": "deleted"
}{
"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"
}
}Get a dataset version
Returns a single dataset version, including its item `schema` and status.
Update a dataset version
Replaces a draft version's item `schema`. Only draft versions are editable; updating a released version returns `400`. The new schema must remain compatible with every existing item, otherwise the request is rejected.