Skip to main content

Unlink Dataset

Page Outline

Removes the dataset association from a model, clearing the active training data source. The dataset itself is not affected.

Base Path: /api/v1/models

Method: DELETE

Path: /{model_id}/dataset

Auth: Requires a valid Bearer token (Authorization: Bearer <JWT>)

Path Parameters

ParameterTypeDescription
model_idstringUnique identifier of the model

Behavior

  • Removes only the link between the model and its currently associated dataset; the dataset record is not deleted.
  • If no dataset is currently linked, the endpoint returns HTTP 404 Not Found.
  • Unlinking is blocked while the model is in training status (the dataset is actively in use). Returns HTTP 409 Conflict in this case.
  • After unlinking, new training runs cannot be triggered until a dataset is re-linked.
  • An audit log entry is written with action model.dataset_unlinked, referencing the removed dataset_id.
  • Returns HTTP 204 No Content on success.

Response

HTTP 204 No Content — no response body.