Workflows

Answer a human-approval step with changes requested

The THIRD outcome of a human-approval step, beside approve and reject.

Approve and reject are terminal for the paused node. This one is not: it sends the run down the revise branch carrying the reviewer's words, so the workflow gets another attempt instead of ending.

post/workflows/executions/request-changes

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/workflows/executions/request-changes
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

workflow_idstring required

The workflow the run belongs to.

requested_bystring required

Who is asking for changes.

feedbackstring required

REQUIRED and non-blank. It is the value the revise branch reads as ${<human_node>.feedback} - an empty one sends the workflow down the revise path with nothing to revise against.

Response

Successful Response

dataVoicePayload required

One voice object - a collection, an agent, a route, a chat.

Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.

Changes

No recorded changes to this operation across all 2 revisions of this API.