v1

latestOpenAPI 3.1.0Proprietary2026-07-265759203.4 KB

Workflow

Create Workflow

Create a new workflow from a block graph definition.

post/workflows/create_workflow

x-api-keystring nullable

workflow_namestring required

Human-readable workflow name.

workflow_descriptionstring required

Human-readable workflow description.

idstring nullable

Optional pre-generated workflow ID supplied by the client.

Successful Response

idstring required

Workflow identifier.

user_uuidstring nullable

User who created the workflow.

org_idstring nullable

Organization that owns the workflow.

namestring required

Workflow name.

descriptionstring nullable

Workflow description.

statusstring required

Lifecycle status of the workflow definition (e.g. draft, ready).

stepstring required

Current authoring step in the builder UI.

created_atstring date-time required

Timestamp when the record was created.

updated_atstring date-time required

Timestamp when the record was last updated.

last_run_datestring date-time nullable

Timestamp of the most recent run.