Check the deployment status of an aligned model.

This endpoint retrieves the current deployment status of a model, including progress and completion information.

Path Parameters:

• model_id: Unique identifier of the model to check deployment status for

Returns:

• model_id: The model identifier
• status: Deployment status
  • UNDEPLOYED: not serving, and deployable
  • DEPLOYING: a deploy is in flight
  • DEPLOYED: serving inference
  • UNDEPLOYING: an undeploy is in flight
• error: why the last attempt failed, null when it succeeded
• created_at, completed_at, updated_at: timestamps
• progress, eta_seconds: not wired up yet, always null

A failed attempt settles back to the state it came from, so read error alongside status: UNDEPLOYED with an error means the deploy failed, DEPLOYED with an error means the undeploy failed.

Raises:

• 404: If model not found or doesn't belong to user

Example Request:

GET /api/v3/models/alignment_01k4x9m2p7q3r8c1/deployment/status
Headers: {"Authorization": "Bearer <api_key>"}

Example Response (deploy in flight):

{
  "model_id": "model_01kmqm4nrn9fw6r",
  "status": "DEPLOYING",
  "error": null,
  "created_at": "2024-02-24T10:00:00Z",
  "completed_at": null,
  "updated_at": "2024-02-24T10:00:00Z",
  "progress": null,
  "eta_seconds": null
}

Example Response (serving):

{
  "model_id": "model_01kmqm4nrn9fw6r",
  "status": "DEPLOYED",
  "error": null,
  "created_at": "2024-02-24T10:00:00Z",
  "completed_at": "2024-02-24T10:05:00Z",
  "updated_at": "2024-02-24T10:05:00Z",
  "progress": null,
  "eta_seconds": null
}

Example Response (deploy failed):

{
  "model_id": "model_01kmqm4nrn9fw6r",
  "status": "UNDEPLOYED",
  "error": "provider rejected the adapter",
  "created_at": "2024-02-24T10:00:00Z",
  "completed_at": "2024-02-24T10:02:30Z",
  "updated_at": "2024-02-24T10:02:30Z",
  "progress": null,
  "eta_seconds": null
}

Notes:

• Poll this endpoint to track deployment progress
• Only DEPLOYED serves inference; every other status returns 400 from the inference endpoints
• A deploy that fails settles at UNDEPLOYED and an undeploy that fails settles at DEPLOYED, both with the reason in error

{
  "model_id": "model_abc123",
  "created_at": "2024-02-24T10:00:00Z",
  "completed_at": "2024-02-24T10:05:00Z"
}