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: train-time alignment in progress
  • READY: train-time alignment 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: train-time alignment 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 train-time alignment has written a checkpoint, so POST /models/{model_id}/deployment?early=true will succeed. Only meaningful while status is still PROCESSING; false once train-time alignment has finished, since a normal deploy applies then.

evaluation_id
string | null

The evaluation created from benchmark_id once train-time alignment finished.

evaluation_status
enum<string> | null

Status of that evaluation, so one poll shows both.

Available options:
PROCESSING,
READY,
FAILED,
DEPLOYING,
EVALUATING,
UNDEPLOYED,
EVALUATED,
STOPPED,
QUEUED
evaluation_message
string | null

Why the evaluation is waiting or why it failed, e.g. every deployment slot of your organisation is in use.