dag-runs

Push back a waiting step in a sub DAG-run for re-execution with feedback

Changed on

Pushes back a step that is in Waiting status within a sub DAG-run, 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}/sub-dag-runs/{subDAGRunId}/steps/{stepName}/push-back

Request

  • Base URL
    http://localhost/api/v1
  • Auth
    • HTTP bearer
    • or HTTP basic
    • or none

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

subDAGRunIdstring required

ID of the sub DAG-run containing the step to push back

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

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new human_task_resume_failed enum value to the response property for the response status

    • warning

      added the new human_task_resume_failed enum value to the response property for the response status

    • warning

      added the new human_task_resume_failed enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new rate_limited enum value to the response property for the response status

    • warning

      added the new rate_limited enum value to the response property for the response status

    • warning

      added the new rate_limited enum value to the response property for the response status