Execute workflow

Create a new pipeline and start execution in one call. This is a convenience endpoint that combines pipeline creation with immediate execution. Returns the pipeline ID and initial status for tracking.

POST /workflows/{id}/execute

Execute workflow

cURL

curl --request POST \
  --url http://localhost:5173/api/flowdrop/workflows/{id}/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": {},
  "options": {
    "timeout": 123,
    "maxSteps": 123
  }
}
'

202

{
  "success": true,
  "data": {
    "execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "started_at": "2023-11-07T05:31:56Z",
    "estimated_completion": "2023-11-07T05:31:56Z"
  },
  "message": "<string>",
  "error": "<string>"
}

Authorizations

BearerAuthSessionAuth

Authorization · string · header · required

JWT token for authentication

Path Parameters

id · string<uuid> · required

Workflow UUID

Body

application/json

inputs · object

Input values for specific nodes

options · object

Show child attributes

Response

202

application/json

Workflow execution started

success · boolean

Whether the request was successful

data · object

Response data (type varies by endpoint)

Show child attributes

message · string

Response message

error · string

Error message (if any)