Skip to main content
PUT
Update workflow

Authorizations

Authorization
string
header
required

Conduit API token. Use Authorization: Bearer <token>. Read/write endpoints require a token with write access.

Path Parameters

id
string
required

Workflow (version) identifier.

Example:

"k17demo8f8x7c9v0n2q4r6t8y1u3i5o"

Body

application/json

Replace a workflow definition by creating a new version under the same workflow. New version is DRAFT unless activate is true.

name
string
required

Workflow name

Minimum string length: 1
steps
object[]
required

The step graph.

workspace_id
string

Optional workspace override. Omit to resolve the workflow's workspace automatically.

description
string | null
color
string

Hex color for the workflow, e.g. #2563eb

trigger
object | null

The workflow trigger, or null for a trigger-less workflow.

first_step_id
string | null

Id of the entry step, or null.

activate
boolean

When true, the version goes live (status ACTIVE). Defaults to false (DRAFT).

Response

Updated workflow definition (new version)

Full workflow definition: metadata, trigger, and the step graph (steps + derived edges) as the Workflows editor stores it. Embedded secrets are redacted.

data
object
required