Run

Poll a /v1/run request

Row status, folded with the compiled pipeline's live progress once one exists (pipeline_id set). status is processing (in flight), completed, failed, or cancelled (the run, or the pipeline behind it, was stopped through POST /v1/run/{id}/cancel) — the same vocabulary POST /v1/run returns. A non-null pipeline_id plus the progress object indicate the pipeline has started. documents (when present) echoes each input's resolved document plus a per-entry live status — omitted entirely for runs submitted before this field shipped. Requires read scope.

get/v1/run/{id}

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/run/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Response

Run request status.

run_idstring uuid
spec_idstring uuid
status'processing' | 'completed' | 'failed' | 'cancelled'
pipeline_idstring uuid nullable
pipeline_mode'new' | 'append'

The EFFECTIVE mode this request resolved to (present only when recorded — omitted for legacy requests). Under append the pipeline is shared across requests, and status/progress are scoped to THIS request's own documents (the same all-terminal fold the per-request webhook fires on), not the whole pipeline.

input_countinteger
error_messagestring nullable
metadataobject nullable

The validated flat metadata object supplied on POST /v1/run, echoed back here.

batch_idstring nullable

The caller grouping key supplied on POST /v1/run, echoed back here.

dispatchfalse

Present only when the request sent dispatch=false.

bindingsobject

The per-node overrides supplied on POST /v1/run (null = that node skipped), echoed back here; present only when sent.

dispatch_skippedboolean

Present only when the request carried delivery controls: true when they suppress at least one Dispatch node (dispatch=false or any null bindings value). Derived from the stored controls; what actually happened per node is on GET /v1/pipelines/{id}/dispatches (status skipped).

created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.