Skip to main content
PATCH
Update a workflow

Authorizations

Authorization
string
header
required

A session token from subscriber login, used by subscriber.dev's own apps. Requests about an environment also need its ID in the x-environment-id header. From your own code, use an API key.

Path Parameters

workflowId
string
required

Body

application/json
key
string
Required string length: 1 - 255
name
string
Required string length: 1 - 255
description
string | null
Maximum string length: 2000
status
enum<string>
Available options:
active,
paused
channels
object

Per-channel settings. Each channel you include replaces that channel's settings; channels you leave out are unchanged.

steps
object[]

If provided, replaces ALL existing steps for this workflow.

Required array length: 1 - 50 elements
triggers
object[]

If provided, replaces ALL existing triggers for this workflow. Automation workflows only; each trigger's integration must be connected.

Maximum array length: 50
exitConditions
object[]

If provided, replaces ALL existing exit conditions for this workflow. Each one's integration must be connected.

Maximum array length: 50

Response

publicId
string
required
key
string
required
name
string
required
description
string | null
required
status
enum<string>
required
Available options:
active,
paused
type
enum<string>
required
Available options:
automation,
broadcast
channels
object
required

Settings for each channel this workflow sends on.

steps
object[]
required
triggers
object[]
required
exitConditions
object[]
required
createdAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
updatedAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
editUrl
string

Link to edit this workflow's emails in the web editor. Share it when someone wants to tweak the copy or preview an email.