Skip to content

Execute a workflow

POST
/workflows/{action_id}/execute

Trigger a workflow run. Returns execution_id for polling.

Pins org_id server-side; the caller cannot override which org’s execution row is created. triggered_by defaults to the caller’s user id when not supplied.

Authorizations

Parameters

Path Parameters

action_id
required

Workflow action_id.

string
>= 1 characters

Workflow action_id.

Header Parameters

X-Target-Org-Id
Any of:
string

Request Body

ExecutionCreateRequest body.

object
key
additional properties
any

Responses

200

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string