Skip to main content
GET
Get Alignment Status

Authorizations

Authorization
string
header
required

Your Nugen API key, sent as a Bearer token

Path Parameters

alignment_id
string
required

ID of the alignment project, returned when it was created

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. Stored as is and returned as is, with no translation in between.

  • QUEUED: accepted and waiting for its workflow to start
  • PROCESSING: running
  • READY: finished successfully
  • FAILED: failed at any stage
  • STOPPED: stopped by the user before completion
Available options:
QUEUED,
PROCESSING,
READY,
FAILED,
STOPPED
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:
QUEUED,
PROCESSING,
READY,
FAILED,
STOPPED
evaluation_message
string | null

Why the evaluation could not be created or why it failed.