Dynamiq
Datasets

Delete a dataset

Deletes a dataset along with all of its versions and items.

DELETE
/v1/datasets/{dataset_id}

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_id*string

Dataset UUID.

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/datasets/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "message": "deleted"
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "forbidden",
    "message": "Forbidden"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

Get a dataset

Returns a single dataset, including its latest released version when one exists.

Create a dataset version

Creates a new draft version of a dataset. Drafts are mutable — you can add items, edit the schema, and release them. An optional `schema` constrains the fields of items added to the version; when omitted, the schema is inferred from the first items added. Draft versions carry a temporary, decreasing `version` number until they are released, at which point they take the next sequential positive version.