Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-243952451019.0 KB
Workflow

Update Workflow

Update a workflow's name or archived flag. run_type is server-controlled and cannot be changed.

patch/workflows/{id}

Path parameters

idstring required

Request body

Example request

{
  "workflow": {
    "name": "Updated Nurture Sequence",
    "archived": false
  }
}

Response

OK

idinteger

Workflow ID

public_idstring nullable

Obfuscated workflow ID

workspace_idinteger

Integer ID of the workspace that owns this workflow

namestring

Human-readable workflow name

status'draft' | 'live' | 'archived'

Derived status. live = enabled with at least one active trigger; archived = archived; otherwise draft.

disabledboolean

True when the workflow is disabled (not executing runs).

archivedboolean

True when the workflow has been archived.

run_type'asynchronous' | 'synchronous' | 'one_time'

How the workflow handles concurrent runs for the same contact. Server-controlled — always asynchronous for API-created workflows.

active_runs_countinteger

Number of currently active (in-progress) runs.

completed_runs_countinteger

Cumulative count of completed runs.

created_atstring date-time

Creation timestamp

updated_atstring date-time

Last update timestamp

Example response

{
  "id": 101,
  "public_id": "WfAbCd",
  "workspace_id": 5001,
  "name": "New Lead Nurture",
  "status": "live",
  "disabled": false,
  "archived": false,
  "run_type": "asynchronous",
  "active_runs_count": 12,
  "completed_runs_count": 340,
  "created_at": "2025-06-01T00:00:00.000Z",
  "updated_at": "2025-06-10T00:00:00.000Z"
}