dag-runs

Push back a waiting step for re-execution with feedback

Pushes back a step that is in Waiting status, providing input parameters that will be injected as environment variables when the step re-executes. The step must have an approval configuration.

post/dag-runs/{name}/{dagRunId}/steps/{stepName}/push-back

Path parameters

namestring regex required

Name of the DAG

name of the DAG

dagRunIdstring required

Unique identifier for the DAG-run. The special value 'latest' can be used to reference the most recent DAG-run.

Example:latest

ID of the DAG-run or 'latest' to get the most recent DAG-run

stepNamestring required

name of the step

Query parameters

remoteNodestring

name of the remote node

Request body

inputsobject

Key-value parameters to provide as feedback. These will be injected as environment variables when the step re-executes.

Response

Step pushed back successfully

dagRunIdstring required

The DAG run ID

stepNamestring required

The pushed-back step name

approvalIterationinteger required

The current approval iteration count after push-back

resumedboolean required

Whether the DAG run was re-enqueued for execution

subDAGRunIdstring

The sub-DAG run ID, present only for sub-DAG push-back operations

Changes

Changed in 3 of the 71 revisions of this API.123

Jul 23, 2026v175b8e91aaf579See the full diff
- ●
  added the new conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new human_task_resume_failed enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new human_task_resume_failed enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new human_task_resume_failed enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new payload_too_large enum value to the response property for the response status
  response-property-enum-value-added
May 24, 2026v18a2d5d3e96083See the full diff
- ●
  added the new rate_limited enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the response property for the response status
  response-property-enum-value-added
Apr 30, 2026v150e1d517afc13See the full diff
- ○
  removed the rate_limited enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the rate_limited enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the rate_limited enum value from the response property for the response status
  response-property-enum-value-removed
This revision also has 86 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history