Skip to main content
PUT
Replace a workflow definition

Authorizations

hookie_session
string
cookie
required

The console's sealed session cookie, set by WorkOS AuthKit. Mutating requests also require the X-Requested-With CSRF header.

Path Parameters

project_id
string
required
workflow_id
string
required

Body

application/json

Identical to the create body and validated by the same validateWorkflowSpec — this is a FULL REPLACE, not a merge: every omitted field reverts to its default (e.g. omitting active re-activates, omitting entry_conditions clears them). PATCH is accepted on this path and behaves identically. version is incremented server-side; it cannot be set.

name
string
required
Required string length: 1 - 120
entry_dataset
string
required
Pattern: ^[a-zA-Z][a-zA-Z0-9_]{0,62}$
steps
object[]
required

Same six step types and same limits as createWorkflow (<= 32 steps including branch sub-steps; branch depth <= 3; no delay/wait_for_event inside a branch).

Minimum array length: 1
slug
string
active
boolean
default:true
entry_conditions
object[]

Response

Replaced; version incremented.

ok
enum<boolean>
required
Available options:
true