Get Run Status
Poll the status, solution, and metadata for a previously submitted run.
Authorizations
Send the credential as Authorization: Bearer <key>.
Scoped partner credentials use the exclusive nxsk_v1_... namespace.
Each scoped key is bound at issuance to one organization, one canonical
named environment, an explicit engine set, and a least-privilege
capability set. A malformed, unknown, rotated, or revoked nxsk_ key
fails closed and is never retried as a legacy key.
Capabilities used by this API are runs:write, runs:read,
engines:read, catalog:read, webhooks:manage,
runs:defensibility:read, runs:test, and converse:use. Operation
descriptions name the required capability.
Grandfathered nx_live_... and nx_test_... keys retain their existing
broad access during the compatibility window.
Path Parameters
The run identifier returned by POST /api/v1/engines/{engine_slug}/runs.
Response
Current run status and results (if completed).
Stable run identifier.
Current run status. queued and processing are
non-terminal: keep polling. completed, degraded, and
failed are terminal. degraded carries the same output
shape as completed plus output.degradation_reason:
treat it as a successful response with a warning, not as
a state to keep polling on.
queued, processing, completed, degraded, failed Environment the run executed in.
test, live Execution attempt count. A terminal value of 1 means no worker retry.
x >= 0RFC 3339 timestamp when the run was created.
Runtime engine type. Omitted on legacy rows without engine metadata.
The released engine version this run executed against
(major.minor), resolved from the engine_version pin at submit
time and frozen for the run's lifetime. Absent when the run used the
engine's current configuration without a pin.
"1.3"
Last known pipeline stage (e.g. EVALUATE, FILTER).
Run summary. Present on completed runs.
Duration of the final execution attempt in milliseconds.
Wall-clock milliseconds from creation to terminal completion.
Error message on failed runs.
Structured failure details.
Trace identifier for support correlation.
^[0-9a-f]{32}$RFC 3339 timestamp when the run reached a terminal state.
Ranked solutions. Present on completed placement runs.
Structured input-quality warnings. Present only when the released engine configuration enables warning exposure.
- object
- object[]