Skip to main content
GET
Get Alignment Project Status

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Response

Returns the current status of an alignment project: state, queue position, stop and failure qualifiers. Poll this; fetch the full record once from GET /alignment-project/{id}.

The polled view of one run: state, its qualifiers, nothing that never changes mid run. Configuration and documents live on the detail route.

alignment_id
string
required

Unique identifier of the alignment project.

status
enum<string>
required

Lifecycle status of a long-running task.

  • QUEUED: accepted and waiting its turn on a bounded queue
  • PROCESSING: training in progress
  • READY: training completed, ready for deployment
  • DEPLOYING: model being deployed for evaluation
  • EVALUATING: evaluation in progress
  • UNDEPLOYED: model being undeployed after evaluation
  • EVALUATED: evaluation completed, model undeployed
  • STOPPED: training stopped by the user before completion
  • FAILED: failed at any stage

QUEUED is derived for the client at read time and never stored, so a task read back later reports PROCESSING once execution has started. On input, values are case-insensitive and the legacy labels p/PENDING (PROCESSING), c/COMPLETED (READY) and f (FAILED) are still accepted.

Available options:
PROCESSING,
READY,
FAILED,
DEPLOYING,
EVALUATING,
UNDEPLOYED,
EVALUATED,
STOPPED,
QUEUED
queue_position
integer | null

Place in the queue while status is QUEUED, 1 meaning next to start.

degraded
boolean | null

True when the run reached its end state but a stage failed on the way.

stage_failures
any[] | null

Stage failures on the way; each entry carries stage, status and failed_reason.

stop_requested_at
string | null

Set once a stop was requested; the run ends STOPPED.

error
string | null

Present when status is FAILED.

early_deployable
boolean
default:false

True once training has written a checkpoint, so POST /models/{model_id}/deployment?early=true will succeed. Only meaningful while status is still PROCESSING; false once training has finished, since a normal deploy applies then.

updated_at
string | null

Last update timestamp.