Skip to main content
GET
Get Alignment Status

Authorizations

Authorization
string
header
required

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

Path Parameters

alignment_id
string
required

Response

Returns the current status of an alignment project: state, timestamps, queue position and stop qualifier. Poll this; fetch the full record, including failure qualifiers, once from GET /alignment-projects/{alignment_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 resource that runs asynchronously.

  • 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 resource 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
created_at
string | null

Timestamp when the project was created.

completed_at
string | null

Timestamp when the project completed; null while still running.

updated_at
string | null

Last update timestamp.

progress
number | null

Completion progress, 0.0 to 100.0. Not wired up yet, always null.

eta_seconds
integer | null

Estimated time remaining in seconds. Not wired up yet, always null.

queue_position
integer | null

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

stop_requested_at
string | null

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

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.