Workflows

Restart one workflow execution

Runs the workflow again FROM THE BEGINNING. Not a resume.

Nodes that already succeeded run a second time. If any of them sent an email, posted to Slack or called a paid API, they do it again. To continue a paused run instead, use POST /workflows/executions/{id}/resume.

The org is forwarded and voice scopes the lookup by it, so one tenant cannot restart another's run.

A restart runs the workflow as it is NOW, with the original or new input. When it has record steps or a record trigger, the key needs the object scopes they exercise (403 missing_scopes), and only the workflow's owner or a graph8 admin may restart it, with reused or new input (403 owner_or_admin_required). When graph8 cannot confirm who is an admin the restart is refused, never guessed: the workflow service answers 503, which reaches the caller as 502 like its other upstream failures; retry later.

post/workflows/executions/{execution_id}/restart

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/workflows/executions/{execution_id}/restart
  • Auth: HTTP bearer

Path parameters

execution_idstring required

Execution id.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

object required

Optional restart overrides.

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.