Endpoint: v1/workflows/{id}
Update a workflow’s name, status, or design. This endpoint supports multiple update scenarios:
Update Scenarios:
Special Behavior: When changing an active workflow to draft status, the system automatically copies the active workflow files to the draft folder, allowing you to make changes without affecting the currently active version.
Note: Creating and editing workflow logic (nodes/edges) is only supported through the dashboard due to the complex ReactFlow JSON format that requires backend transformation.
API key with format "Bearer {your-api-key}"
Unique identifier of the workflow
Workflow name. Must be:
1 - 100"Welcome Email Series"
Workflow status:
draft: Workflow is in draft mode (not active)active: Workflow is active and will trigger on eventspaused: Workflow is paused (will not trigger)draft, active, paused "active"
ReactFlow JSON workflow design. This is a complex object structure that should be created through the dashboard.
Note: This field is only used when updating workflow logic through the API. Most workflow updates should be done through the dashboard due to the complexity of the ReactFlow JSON format and backend transformation requirements.
{
"nodes": [
{
"id": "trigger",
"type": "trigger",
"position": { "x": 100, "y": 100 },
"data": { "eventName": "user_signed_up" }
}
],
"edges": []
}Workflow successfully updated