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
| Parameter | Type | Description |
|---|---|---|
model_id | string | Unique 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
trainingstatus (the dataset is actively in use). ReturnsHTTP 409 Conflictin 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 removeddataset_id. - Returns
HTTP 204 No Contenton success.
Response
HTTP 204 No Content — no response body.