Skip to main content
POST
/
api
/
v1
/
workflows
curl -X POST \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_type": "MyWorkflow",
    "task_queue": "my-task-queue",
    "workflow_id": "manual-run-001",
    "input": {
      "key": "value"
    }
  }' \
  /api/v1/workflows

{
  "workflowId": "manual-run-001",
  "runId": "9b8e7f6a-5d4c-3b2a-1f0e-9d8c7b6a5f4e"
}
Start a new workflow execution. Provide the workflow type, task queue, and optional input data. Returns the assigned workflow ID and run ID on success.
​
workflow_type
string
required
The workflow type to execute. Must match a registered workflow name.
​
task_queue
string
required
The task queue where this workflow should be executed.
​
workflow_id
string
Custom workflow ID. If omitted, a unique ID will be generated.
​
input
any
Input data for the workflow. Will be JSON-serialized and passed to the workflow.
curl -X POST \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_type": "MyWorkflow",
    "task_queue": "my-task-queue",
    "workflow_id": "manual-run-001",
    "input": {
      "key": "value"
    }
  }' \
  /api/v1/workflows

{
  "workflowId": "manual-run-001",
  "runId": "9b8e7f6a-5d4c-3b2a-1f0e-9d8c7b6a5f4e"
}