dag-runs

Approve a waiting step

Changed on

Approves a waiting step and requests resume when work is ready. Approval and inputs remain saved if resume admission fails; use the run resume endpoint to retry without approving again.

post/dag-runs/{name}/{dagRunId}/steps/{stepName}/approve

Request

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. These will be available as environment variables in subsequent steps.

Response

Step approved successfully

dagRunIdstring required

The DAG run ID

stepNamestring required

The approved step name

resumedboolean required

Whether resume execution was accepted, directly or through a queue

Changes

    • info

      added the non-success response with the status

    • info

      added the non-success response with the 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 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