Archive Model

Page Outline

Transitions a model to archived status, removing it from default list views while preserving all version history, metrics, and audit logs.

Base Path: /api/v1/models

Method: POST

Path: /{model_id}/archive

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

Path Parameters

Parameter	Type	Description
`model_id`	string	Unique identifier of the model to archive

Archiving is a soft action — no data is deleted. The model remains queryable via GET /{model_id} and via GET / with status=archived.
Archiving is blocked if the model has an active deployment. The caller must undeploy first.
Models in training status cannot be archived; the training job must complete or be cancelled.
An audit log entry is written with action model.archived.
An already-archived model returns HTTP 409 Conflict.
To reverse, use the Unarchive Model endpoint.

Returns the updated Model object with "status": "archived".

{
  "id": "mdl-7f3a19bc",
  "name": "My Churn Predictor",
  "status": "archived",
  "archived_at": "2026-03-13T15:00:00Z"
}