Skip to main content
POST
Create 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_schema
object
required

Complete WorkflowDefinition (required).

name
string

Workflow name. Falls back to schema metadata if omitted.

slug
string

URL-friendly identifier. Auto-generated from name if omitted.

description
string
category
string
status
string
default:draft
visibility
string
default:organization
tags
string[]
version
string
input
object

Default input parameters.

config
object

Default execution config.

Response

The created workflow.

A workflow definition and its metadata.

id
string<uuid>
organization_id
string<uuid>
creator_id
string<uuid> | null
name
string
description
string | null
version
string | null
tags
string[]
category
string | null
status
string
Example:

"draft"

visibility
string
Example:

"organization"

workflow_schema
object

Full WorkflowDefinition (nodes, edges, state_schema, metadata).

input
object

Default input parameters.

config
object

Default execution config.

edit_version
integer | null
last_edited_by
string<uuid> | null
last_edited_at
string<date-time> | null
created_at
string<date-time>
updated_at
string<date-time>