Skip to main content
POST
Run a workflow

Authorizations

Authorization
string
header
required

User API key: Authorization: Bearer mx_live_*. The X-API-KEY: mx_live_* header is also accepted.

X-Organization-ID
string
header
required

Required organization context for org-scoped endpoints.

Body

application/json
workflow_id
string<uuid>
required

The workflow to execute.

input
object

Run inputs matching the workflow state schema.

Response

Run accepted and started in the background.

Acknowledgement that the run started in the background.

status
string
Example:

"running"

run_id
string<uuid>
thread_id
string | null
chat_id
string<uuid> | null

Null when ephemeral=true.

ephemeral
boolean
stream
boolean
workflow_name
string
workflow_version
string | null
workflow_source
string

One of: database, request, system:.

Example:

"database"

elapsed_ms
number
human_message
object | null
ai_message
object | null
message
string