Skip to main content
POST
Execute a Workflow

Authorizations

X-API-Key
string
header
required

API key for authenticating requests to the Flowker API. Provisioned via the API_KEY environment variable during deployment.

Headers

Idempotency-Key
string
required

Unique idempotency key to ensure safe retries of the same request.

Path Parameters

workflowId
string<uuid>
required

Unique identifier of the workflow.

Body

application/json

Request body containing the execution input data.

inputData
object
required

Input data passed to the workflow. Available to all nodes during execution. Maximum payload size is 1 MB.

Example:

Response

Indicates that an identical request was already processed. Returns the original execution.

executionId
string<uuid>

Unique identifier of the execution.

Example:

"f7e6d5c4-b3a2-1098-7654-321fedcba098"

startedAt
string<date-time>

Timestamp when the execution started.

Example:

"2026-03-17T14:35:00Z"

status
string

Initial status of the execution (always pending).

Example:

"running"

workflowId
string<uuid>

ID of the workflow being executed.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"