Skip to main content
POST
Trigger workflow execution

Authorizations

Authorization
string
header
required

API key passed as an Authorization Bearer token: Authorization: Bearer YOUR_API_KEY

Path Parameters

workflowID
string
required

Workflow ID or slug to execute.

versionID
string
required

Workflow version ID to execute.

Query Parameters

webhook_url
string<uri>

Optional compatibility query parameter for execution completion webhooks. The request body field takes precedence when both are present.

Body

application/json
inputs
object

Input values defined by the workflow version. May be omitted for workflows with no inputs.

Example:
webhook_url
string<uri>

Optional webhook URL for workflow execution completion.

Example:

"https://your-app.com/webhook"

webhook_secret
string

Optional secret used to sign workflow webhook requests.

Example:

"your-secret-key"

Response

Workflow execution queued

execution_id
string

Queued workflow execution identifier.

Example:

"exec_xyz789"

status
enum<string>

Execution queue status returned immediately after triggering.

Available options:
queued
Example:

"queued"

Last modified on July 27, 2026