Get run
Inspect accepted inputs, immutable requirements and current run state.
Credential scopes: runs:read
Resource authority: Run submitter or current model owner/co-admin; model-administrator reads are audited. Connector administration and model execution grants alone confer no scientific read access.
Retry: Repeat GET using the same resource identity; each request rechecks current credential and resource authority.
Guards: No mutation or execution authority is granted.
Retain: Run identity; opaque cursor where returned.
Specific failures: 403 insufficient_scope; 404 not_found: missing or unauthorized resource
Next action: Inspect current state; follow exact referenced artifact identities. Worked workflow
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Accepted run identity.
Responses
Section titled “Responses”Accepted inputs, immutable requirements and current public state for the submitter or current model owner/co-admin, using these same routes. No query parameters are accepted.
Current state alongside the original immutable acceptance facts.
object
API receipt time of the latest qualifying execution observation.
API confirmation age: fresh below 60 seconds, stale at or above 60 seconds. Missing or future confirmation times are unknown.
Immutable publication captured at acceptance.
Immutable submission intent. Candidate trials retain author/compute authority checks.
Public execution state. Delegated preparation and collection are running.
Durable user intent, distinct from current execution authorization.
object
Set only after confirmed termination (or cancellation before assignment).
The retained actor may be an connector administrator for queued-only cutover.
Creator cancellation covers pending and running work. Connector context-cutover cancellation is queued-only and retains the actual actor and reason.
Public execution state. Delegated preparation and collection are running.
A request does not confirm termination. Completion can win a cancellation race.
Durable result for the submitter and current model owners/co-admins.
object
object
Closed immutable collection reference used by scientific inputs and results.
object
object
Closed public stored-file reference, never a path or transfer capability.
object
object
Private bounded failure details, never included in diagnostics or tracing.
object
At most 2048 UTF-8 bytes. Only tab and newline control characters allowed.
Original committed acknowledgement, independent of later inspection time.
object
True only after this result and every file pin have committed. It permits removal of provider work files, never deletion of API-retained artifacts. Historical receipts and operator resolutions carry no cleanup authority.
Absent on pre-storage work and scalar-only installations without a default.
Examples
queued-run
One accepted scalar run, followed through coherent queued, running and terminal observations. Replay returns the original queued receipt, not the current inspection.
{ "blocked_reason": null, "cancellation": null, "cancelled_at": null, "context_id": "lab-cpu", "contract_version": 1, "created_at": "2026-11-02T10:00:00Z", "created_by_user_id": "00000000-0000-4000-8000-000000000002", "disclosure": "This model runs on the laboratory CPU host.", "effective_inputs": { "value": 2 }, "execution_control": { "authorization_reason": null, "state": "authorized" }, "execution_location": "Approved laboratory CPU host", "last_observed_at": null, "model_id": "scalar-double", "observation_freshness": "unknown", "phase": null, "publication_id": "scalar-double-r1", "purpose": "standard", "requested_inputs": { "value": 2 }, "resolution": null, "result": null, "run_id": "00000000-0000-4000-8000-000000000001", "state": "queued"}running-run
One accepted scalar run, followed through coherent queued, running and terminal observations. Replay returns the original queued receipt, not the current inspection.
{ "blocked_reason": null, "cancellation": null, "cancelled_at": null, "context_id": "lab-cpu", "contract_version": 1, "created_at": "2026-11-02T10:00:00Z", "created_by_user_id": "00000000-0000-4000-8000-000000000002", "disclosure": "This model runs on the laboratory CPU host.", "effective_inputs": { "value": 2 }, "execution_control": { "authorization_reason": null, "state": "authorized" }, "execution_location": "Approved laboratory CPU host", "last_observed_at": "2026-11-02T10:01:00Z", "model_id": "scalar-double", "observation_freshness": "fresh", "phase": "executing", "publication_id": "scalar-double-r1", "purpose": "standard", "requested_inputs": { "value": 2 }, "resolution": null, "result": null, "run_id": "00000000-0000-4000-8000-000000000001", "state": "running"}succeeded-run
One accepted scalar run, followed through coherent queued, running and terminal observations. Replay returns the original queued receipt, not the current inspection.
{ "blocked_reason": null, "cancellation": null, "cancelled_at": null, "context_id": "lab-cpu", "contract_version": 1, "created_at": "2026-11-02T10:00:00Z", "created_by_user_id": "00000000-0000-4000-8000-000000000002", "disclosure": "This model runs on the laboratory CPU host.", "effective_inputs": { "value": 2 }, "execution_control": { "authorization_reason": null, "state": "completed" }, "execution_location": "Approved laboratory CPU host", "last_observed_at": "2026-11-02T10:01:00Z", "model_id": "scalar-double", "observation_freshness": "fresh", "phase": null, "publication_id": "scalar-double-r1", "purpose": "standard", "requested_inputs": { "value": 2 }, "resolution": null, "result": { "failure": null, "files": {}, "optional_output_failures": {}, "outputs": { "doubled": 4 }, "receipt": { "assignment_id": "00000000-0000-4000-8000-000000000003", "attempt_id": "00000000-0000-4000-8000-000000000004", "completed_at": "2026-11-02T10:01:00Z", "outcome": "succeeded", "run_id": "00000000-0000-4000-8000-000000000001" } }, "run_id": "00000000-0000-4000-8000-000000000001", "state": "succeeded"}Headers
Section titled “Headers”No-store
Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.
Run detail does not accept query parameters. Code bad_request.
The common JSON body for errors returned by the HTTP application.
object
Stable machine-readable error code.
Bounded corrections for authorized scientific-schema failures only. Absent on other failures. The complete validation error body is <=4608 bytes.
object
More violations exist than fit in this response.
At most eight violations, in validator traversal order.
A schema failure without submitted values or arbitrary property names.
object
Fixed guidance; actual bounds and allowed values remain in the publication schema.
JSON Pointer relative to inputs; the empty string denotes its root.
Only ordinary, explicitly declared property names and array indices appear.
Example
/valueThe position stops at a safe ancestor instead of naming the exact field.
Stable categories independent of the validator’s free-form diagnostics.
Safe explanation without internal errors or submitted input values.
Matches the response’s x-request-id header.
Headers
Section titled “Headers”No-store
Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.
An active user credential is required. Code unauthenticated.
The common JSON body for errors returned by the HTTP application.
object
Stable machine-readable error code.
Bounded corrections for authorized scientific-schema failures only. Absent on other failures. The complete validation error body is <=4608 bytes.
object
More violations exist than fit in this response.
At most eight violations, in validator traversal order.
A schema failure without submitted values or arbitrary property names.
object
Fixed guidance; actual bounds and allowed values remain in the publication schema.
JSON Pointer relative to inputs; the empty string denotes its root.
Only ordinary, explicitly declared property names and array indices appear.
Example
/valueThe position stops at a safe ancestor instead of naming the exact field.
Stable categories independent of the validator’s free-form diagnostics.
Safe explanation without internal errors or submitted input values.
Matches the response’s x-request-id header.
Headers
Section titled “Headers”No-store
Bearer
Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.
The credential does not permit this operation (insufficient_scope).
The common JSON body for errors returned by the HTTP application.
object
Stable machine-readable error code.
Bounded corrections for authorized scientific-schema failures only. Absent on other failures. The complete validation error body is <=4608 bytes.
object
More violations exist than fit in this response.
At most eight violations, in validator traversal order.
A schema failure without submitted values or arbitrary property names.
object
Fixed guidance; actual bounds and allowed values remain in the publication schema.
JSON Pointer relative to inputs; the empty string denotes its root.
Only ordinary, explicitly declared property names and array indices appear.
Example
/valueThe position stops at a safe ancestor instead of naming the exact field.
Stable categories independent of the validator’s free-form diagnostics.
Safe explanation without internal errors or submitted input values.
Matches the response’s x-request-id header.
Headers
Section titled “Headers”No-store
Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.
Run identity is invalid, absent or unauthorized. Submitters and current model owners/co-admins may inspect. Code not_found.
The common JSON body for errors returned by the HTTP application.
object
Stable machine-readable error code.
Bounded corrections for authorized scientific-schema failures only. Absent on other failures. The complete validation error body is <=4608 bytes.
object
More violations exist than fit in this response.
At most eight violations, in validator traversal order.
A schema failure without submitted values or arbitrary property names.
object
Fixed guidance; actual bounds and allowed values remain in the publication schema.
JSON Pointer relative to inputs; the empty string denotes its root.
Only ordinary, explicitly declared property names and array indices appear.
Example
/valueThe position stops at a safe ancestor instead of naming the exact field.
Stable categories independent of the validator’s free-form diagnostics.
Safe explanation without internal errors or submitted input values.
Matches the response’s x-request-id header.
Headers
Section titled “Headers”No-store
Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.
413: the request body exceeds the configured size limit.
The common JSON body for errors returned by the HTTP application.
object
Stable machine-readable error code.
Bounded corrections for authorized scientific-schema failures only. Absent on other failures. The complete validation error body is <=4608 bytes.
object
More violations exist than fit in this response.
At most eight violations, in validator traversal order.
A schema failure without submitted values or arbitrary property names.
object
Fixed guidance; actual bounds and allowed values remain in the publication schema.
JSON Pointer relative to inputs; the empty string denotes its root.
Only ordinary, explicitly declared property names and array indices appear.
Example
/valueThe position stops at a safe ancestor instead of naming the exact field.
Stable categories independent of the validator’s free-form diagnostics.
Safe explanation without internal errors or submitted input values.
Matches the response’s x-request-id header.
Headers
Section titled “Headers”No-store
Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.
Authentication or run inspection is temporarily unavailable. Code run_inspection_unavailable for inspection failures.
The common JSON body for errors returned by the HTTP application.
object
Stable machine-readable error code.
Bounded corrections for authorized scientific-schema failures only. Absent on other failures. The complete validation error body is <=4608 bytes.
object
More violations exist than fit in this response.
At most eight violations, in validator traversal order.
A schema failure without submitted values or arbitrary property names.
object
Fixed guidance; actual bounds and allowed values remain in the publication schema.
JSON Pointer relative to inputs; the empty string denotes its root.
Only ordinary, explicitly declared property names and array indices appear.
Example
/valueThe position stops at a safe ancestor instead of naming the exact field.
Stable categories independent of the validator’s free-form diagnostics.
Safe explanation without internal errors or submitted input values.
Matches the response’s x-request-id header.
Headers
Section titled “Headers”No-store
Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.
default
Section titled “default”An HTTP request failed; inspect the stable error code and request ID.
The common JSON body for errors returned by the HTTP application.
object
Stable machine-readable error code.
Bounded corrections for authorized scientific-schema failures only. Absent on other failures. The complete validation error body is <=4608 bytes.
object
More violations exist than fit in this response.
At most eight violations, in validator traversal order.
A schema failure without submitted values or arbitrary property names.
object
Fixed guidance; actual bounds and allowed values remain in the publication schema.
JSON Pointer relative to inputs; the empty string denotes its root.
Only ordinary, explicitly declared property names and array indices appear.
Example
/valueThe position stops at a safe ancestor instead of naming the exact field.
Stable categories independent of the validator’s free-form diagnostics.
Safe explanation without internal errors or submitted input values.
Matches the response’s x-request-id header.
Headers
Section titled “Headers”No-store
Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.
Documentation 205dcb3116ea · public sources 8c70356d340f · built .Download documentation identity.