Skip to main content
PATCH
Update a workflow by ID
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. A public v1 replacement is not currently listed in the v1 reference. This endpoint remains available for existing integrations until then.
Updates one or more editable fields on a workflow. The name and description can be edited at any time and the change applies immediately. The workflow’s status cannot be changed through this endpoint, use the dedicated lifecycle endpoints (Pause, Resume, Cancel, Activate) so the audit trail records the intent cleanly.

When to use this

  • Renaming a workflow after the underlying campaign or sequence is renamed in your internal systems.
  • Editing the description so dashboard viewers see a more accurate summary of what the workflow does.
  • Bulk metadata updates when reorganizing workspaces across teams.
To change the graph (nodes and edges), use the workflow-nodes and workflow-edges endpoints. To change lead enrollment, use Upload Workflow Leads and Remove Lead.

Path parameters

Errors

  • 404 Not Found is returned when the workflow does not exist.
  • 400 Bad Request is returned when the body contains no editable fields or when a value fails validation.
  • 409 Conflict is returned if you try to change status through this endpoint, use the lifecycle endpoints instead.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-organization-id
string
required

RSA encrypted organization ID (base64 format)

Example:

"BASE64_ENCRYPTED_ORG_ID_HERE"

Path Parameters

id
string
required

Body

application/json
title
string

Title of the workflow (max 100 characters)

Maximum string length: 100
Example:

"Updated Customer Onboarding Workflow"

description
string

Description of the workflow

Example:

"Updated description"

status
enum<string>

Status of the workflow

Available options:
draft,
active,
paused,
completed,
cancelled
Example:

"active"

fallback_variables
object[]

Workflow-level default values for lead variables missing on a lead

Example:

Response

Workflow updated successfully