Start a workflow run

Start a run of a published workflow from its manual trigger with an optional instruction, declared inputs and documents. Returns the queued run; poll workflows.runs.get for progress.

Authorization

bearerApiKey

AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

Header Parameters

X-Request-Id?string

Optional correlation identifier.

Lengthlength <= 128

Idempotency-Key*string

A unique key for this intended write. Reuse it only for an identical retry.

Length1 <= length <= 200

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

workflow_id*string

Formatuuid

node_id?string

Trigger node to start from; defaults to the first enabled manual trigger.

Lengthlength <= 80

input?

version_id?string

Run an earlier published version instead of the current one.

Formatuuid

origin?string

Only manual is allowed for callers; the platform sets schedule, event and webhook.

Value in

"manual"
"schedule"
"event"
"webhook"
"partner"
"sub_workflow"
"test"

trigger_payload?|null

webhook_id?string

Platform only: webhook that received the request.

Formatuuid

trigger_id?string

Platform only: trigger that fired.

Formatuuid

trigger_firing_id?string

Platform only: firing that started this run.

Formatuuid

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/workflow-runs" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{    "workflow_id": "123e4567-e89b-42d3-a456-426614174000"  }'

{  "id": "123e4567-e89b-42d3-a456-426614174000",  "workflow_id": "123e4567-e89b-42d3-a456-426614174000",  "workflow_name": "Invoice approval",  "space_id": "123e4567-e89b-42d3-a456-426614174000",  "version": {    "id": "123e4567-e89b-42d3-a456-426614174000",    "version": 0  },  "origin": "manual",  "actor_type": "api",  "trigger_id": "123e4567-e89b-42d3-a456-426614174000",  "webhook_id": "123e4567-e89b-42d3-a456-426614174000",  "parent_run_id": "123e4567-e89b-42d3-a456-426614174000",  "trigger_node_id": "example",  "test_node_id": "example",  "status": "ACTIVE",  "error_code": "example",  "error_message": "example",  "error_details": {},  "retry_of": "123e4567-e89b-42d3-a456-426614174000",  "activations_total": 0,  "cost_micro_usd": 0,  "micro_credits": 0,  "requested_by": {    "id": "123e4567-e89b-42d3-a456-426614174000",    "email": "ada@example.com",    "name": "Customer documents",    "image_url": "example"  },  "created_at": "2026-09-04T12:00:00Z",  "started_at": "2026-09-04T12:00:00Z",  "completed_at": "2026-09-04T12:00:00Z",  "wake_at": "2026-09-04T12:00:00Z"}

Authorization

Header Parameters

Request Body

Response Body

202application/json

400application/problem+json

401application/problem+json

402application/problem+json

403application/problem+json

404application/problem+json

405application/problem+json

409application/problem+json

410application/problem+json

413application/problem+json

415application/problem+json

422application/problem+json

429application/problem+json

500application/problem+json

502application/problem+json

503application/problem+json

504application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`