Delete Model

Page Outline

• Path Parameters
• Query Parameters
• Behavior
• Response

---

Permanently deletes a model and all associated resources, including versions, training runs, metrics, and logs. This action is irreversible.

Base Path: /api/v1/models

Method: DELETE

Path: /{model_id}

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

Path Parameters

Parameter	Type	Description
model_id	string	Unique identifier of the model to delete

Query Parameters

Parameter	Type	Default	Description
force	boolean	false	If true, deletes even if the model is in training or ready status

Behavior

• By default, deletion is blocked for models in training status. Pass force=true to override and cancel any running training job before deletion.
• Models with active deployments cannot be deleted even with force=true; the caller must remove all deployments first.
• Cascades deletion to: all model versions, all training run records, all metrics/logs, all audit log references (soft-delete only).
• Dataset links are unlinked, not deleted — the source dataset is unaffected.
• An audit log entry is written with action model.deleted before the record is removed.
• Returns HTTP 204 No Content on success.
• Returns HTTP 404 Not Found if the model does not exist or is not accessible by the caller.

Response

HTTP 204 No Content — no response body.