---
title: "updateFlowTemplate"
method: PUT
path: "/v2/flows/templates/{flowId}"
tags: ["Flows V2"]
---

# updateFlowTemplate

`PUT /v2/flows/templates/{flowId}`

Update Flow Template.

## Path parameters

- `flowId` string, required — Short unique id (length 8) to identify the Flow Template.

## Query parameters

- `enforce_limits` boolean

## Request body

- FlowTemplate — Base schema for V2 flow templates. A flow template defines the structure of a workflow including phases, tasks, edges, triggers, and other configuration. Flow templates serve as blueprints that can be instantiated as flow executions.
  - `id` string — Unique identifier for the flow template, generated by the system.
  - `org_id` string — Organization identifier that owns this flow template.
  - `name` string, required — Display name for the workflow, shown to users in the UI.
  - `description` string — Optional detailed description of the workflow's purpose and behavior.
  - `trigger` union
    - ManualTrigger
      - `id` string
      - `type` 'manual', required
      - `entity_schema` string
    - AutomationTrigger
      - `id` string
      - `type` 'automation', required
      - `automation_id` string — Id of the automation config that triggers this workflow
      - `input_entity` 'thread' | 'first_email' | 'last_email' — For email thread triggers, specifies which entity from the triggered email thread to use as the primary input for automation and decision tasks. Defaults to `thread` when not specified.
      - `trigger_config` object[] — Transient field. Trigger configurations for creating or updating the trigger automation flow. Each item follows the automation API trigger schema. Processed by the backend during create/update and stripped before storage.
        - `type` string, required — The trigger type (e.g. entity_operation, activity)
        - `configuration` object — Trigger-specific configuration
    - JourneySubmissionTrigger
      - `id` string
      - `type` 'journey_submission', required
      - `journey_id` string, required — ID of the journey that will trigger this flow
      - `journey_name` string — Name of the journey that will trigger this flow
      - `automation_id` string
    - JourneyAutomationTrigger
      - `id` string
      - `type` 'journey_automation', required
      - `entity_schema` string — Schema of the main entity where flow will be triggered. The entity will be picked from automation context.
  - `enabled` boolean — Whether the workflow is enabled or not
  - `version` 'v1' | 'v2' | 'v3' — Version of the workflow schema. - `v1` – *Deprecated*. The initial version of workflows with limited structure and automation capabilities. - `v2` – Linear workflows. Supports sequential task execution with basic automation triggers. - `v3` – Advanced workflows. Adds support for branching logic (conditions), parallel paths, and enhanced automation features such as dynamic triggers and flow control.
  - `created_at` string — ISO String Date & Time
  - `updated_at` string — ISO String Date & Time
  - `due_date` string
  - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
    - `duration` number, required
    - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
    - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
    - `task_id` string
    - `phase_id` string
  - `assigned_to` union[]
    - union
      - string
      - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
        - `variable` string, required — The variable expression, e.g., "{{entity.owner}}"
        - `value` string[] — The resolved values after variable evaluation (populated during execution)
  - `available_in_ecp` boolean — Indicates whether this workflow is available for End Customer Portal or not. By default it's not.
  - `additional_triggers` Trigger[] — Additional trigger configurations that can also start this flow. Useful for flows that should be startable via multiple methods (e.g., both automation AND manual).
    - union
      - ManualTrigger
        - `id` string
        - `type` 'manual', required
        - `entity_schema` string
      - AutomationTrigger
        - `id` string
        - `type` 'automation', required
        - `automation_id` string — Id of the automation config that triggers this workflow
        - `input_entity` 'thread' | 'first_email' | 'last_email' — For email thread triggers, specifies which entity from the triggered email thread to use as the primary input for automation and decision tasks. Defaults to `thread` when not specified.
        - `trigger_config` object[] — Transient field. Trigger configurations for creating or updating the trigger automation flow. Each item follows the automation API trigger schema. Processed by the backend during create/update and stripped before storage.
          - `type` string, required — The trigger type (e.g. entity_operation, activity)
          - `configuration` object — Trigger-specific configuration
      - JourneySubmissionTrigger
        - `id` string
        - `type` 'journey_submission', required
        - `journey_id` string, required — ID of the journey that will trigger this flow
        - `journey_name` string — Name of the journey that will trigger this flow
        - `automation_id` string
      - JourneyAutomationTrigger
        - `id` string
        - `type` 'journey_automation', required
        - `entity_schema` string — Schema of the main entity where flow will be triggered. The entity will be picked from automation context.
  - `phases` Phase[]
    - `id` string, required
    - `name` string, required
    - `due_date` string
    - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
      - `duration` number, required
      - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
      - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
      - `task_id` string
      - `phase_id` string
    - `assigned_to` union[]
      - union
        - string
        - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
          - `variable` string, required — The variable expression, e.g., "{{entity.owner}}"
          - `value` string[] — The resolved values after variable evaluation (populated during execution)
    - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
  - `tasks` Task[], required
    - union
      - ManualTask
        - `id` string, required
        - `name` string, required
        - `description` StepDescription — Longer information regarding Task
          - `enabled` boolean
          - `value` string
        - `journey` StepJourney
          - `id` string
          - `journeyId` string
          - `name` string
          - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `due_date` string
        - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
          - `duration` number, required
          - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
          - `task_id` string
          - `phase_id` string
        - `requirements` EnableRequirement[] — requirements that need to be fulfilled in order to enable the task while flow instances are running
          - `task_id` string — The id of the task that it points to
          - `phase_id` string — The id of the phase that it points to
          - `when` 'TASK_FINISHED' | 'PHASE_FINISHED', required
        - `assigned_to` union[]
          - union
            - string
            - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
              - …
        - `ecp` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `installer` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `partner` PartnerDetails — Details regarding partner for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
        - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
        - `phase_id` string
        - `task_type` 'MANUAL' | 'AUTOMATION' | 'DECISION' | 'AI_AGENT', required
      - AutomationTask
        - `id` string, required
        - `name` string, required
        - `description` StepDescription — Longer information regarding Task
          - `enabled` boolean
          - `value` string
        - `journey` StepJourney
          - `id` string
          - `journeyId` string
          - `name` string
          - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `due_date` string
        - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
          - `duration` number, required
          - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
          - `task_id` string
          - `phase_id` string
        - `requirements` EnableRequirement[] — requirements that need to be fulfilled in order to enable the task while flow instances are running
          - `task_id` string — The id of the task that it points to
          - `phase_id` string — The id of the phase that it points to
          - `when` 'TASK_FINISHED' | 'PHASE_FINISHED', required
        - `assigned_to` union[]
          - union
            - string
            - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
              - …
        - `ecp` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `installer` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `partner` PartnerDetails — Details regarding partner for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
        - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
        - `phase_id` string
        - `task_type` 'MANUAL' | 'AUTOMATION' | 'DECISION' | 'AI_AGENT', required
        - `automation_config` AutomationConfig, required — Configuration for automation execution to run
          - `flow_id` string — Id of the configured automation to run
          - `action_config` object — Transient field. The full automation action configuration following the automation API action schema. Processed by the backend during create/update and stripped before storage. When present without a flow_id, a new automation flow is created. When present with a flow_id, the existing automation flow is updated.
            - `type` string, required — The action type (e.g. send-email, trigger-workflow)
            - `config` object — Action-specific configuration
          - `duplicated_flow_id` string — Transient field. When present, the backend clones the automation flow referenced by this ID and assigns the new flow_id to the task. Used when duplicating an automation task to give it an independent automation. Stripped before storage.
          - `input_context` AutomationInputContext — Optional. Source of the entity fed into this automation task. If omitted, the workflow's primary entity is used.
            - `source` 'trigger' | 'task', required — `trigger` = workflow's primary (trigger) entity. `task` = entity produced by an upstream task in the graph.
            - `task_id` string — Required when source is `task`. The id of the upstream task whose output entity should feed this task.
        - `trigger_mode` 'manual' | 'automatic'
        - `schedule` union
          - ImmediateSchedule
            - `mode` 'immediate'
          - DelayedSchedule
            - `mode` 'delayed', required
            - `duration` number, required
            - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - RelativeSchedule
            - `mode` 'relative', required
            - `direction` 'before' | 'after', required
            - `duration` number, required
            - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
            - `reference` object, required
              - …
        - `created_automatically` boolean — Indicates whether this task was created automatically by journeys or manually by an user
      - DecisionTask
        - `id` string, required
        - `name` string, required
        - `description` StepDescription — Longer information regarding Task
          - `enabled` boolean
          - `value` string
        - `journey` StepJourney
          - `id` string
          - `journeyId` string
          - `name` string
          - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `due_date` string
        - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
          - `duration` number, required
          - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
          - `task_id` string
          - `phase_id` string
        - `requirements` EnableRequirement[] — requirements that need to be fulfilled in order to enable the task while flow instances are running
          - `task_id` string — The id of the task that it points to
          - `phase_id` string — The id of the phase that it points to
          - `when` 'TASK_FINISHED' | 'PHASE_FINISHED', required
        - `assigned_to` union[]
          - union
            - string
            - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
              - …
        - `ecp` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `installer` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `partner` PartnerDetails — Details regarding partner for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
        - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
        - `phase_id` string
        - `task_type` 'MANUAL' | 'AUTOMATION' | 'DECISION' | 'AI_AGENT', required
        - `trigger_mode` 'manual' | 'automatic', required
        - `conditions` Condition[], required
          - `id` string, required
          - `branch_name` string, required — The name of the branch
          - `logical_operator` 'AND' | 'OR', required
          - `statements` Statement[], nullable, required
            - `id` string, required
            - `source` EvaluationSource, required
              - …
            - `operator` 'equals' | 'not_equals' | 'any_of' | 'none_of' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with' | 'greater_than' | 'less_than' | 'greater_than_or_equals' | 'less_than_or_equals' | 'is_empty' | 'is_not_empty', required
            - `values` string[], required
            - `value_type` 'static' | 'relative_date' — How to interpret values. "static" (default) means literal values. "relative_date" means values[0] is a dynamic date token like "today".
        - `allow_parallel_execution` boolean — When true, all branches with met conditions execute in parallel. When false, only the first branch with a met condition is executed. Defaults to true for backwards compatibility.
        - `schedule` union
          - DelayedSchedule
            - `mode` 'delayed', required
            - `duration` number, required
            - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - RelativeSchedule
            - `mode` 'relative', required
            - `direction` 'before' | 'after', required
            - `duration` number, required
            - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
            - `reference` object, required
              - …
        - `loop_config` object
          - `loop_branch_id` string, required — The id of the branch that will be looped
          - `exit_branch_id` string, required — The id of the branch that will be used to exit the loop
          - `max_iterations` integer, required — Maximum number of iterations for the loop branch
      - AiAgentTask
        - `id` string, required
        - `name` string, required
        - `description` StepDescription — Longer information regarding Task
          - `enabled` boolean
          - `value` string
        - `journey` StepJourney
          - `id` string
          - `journeyId` string
          - `name` string
          - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `due_date` string
        - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
          - `duration` number, required
          - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
          - `task_id` string
          - `phase_id` string
        - `requirements` EnableRequirement[] — requirements that need to be fulfilled in order to enable the task while flow instances are running
          - `task_id` string — The id of the task that it points to
          - `phase_id` string — The id of the phase that it points to
          - `when` 'TASK_FINISHED' | 'PHASE_FINISHED', required
        - `assigned_to` union[]
          - union
            - string
            - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
              - …
        - `ecp` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `installer` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `partner` PartnerDetails — Details regarding partner for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
        - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
        - `phase_id` string
        - `task_type` 'MANUAL' | 'AUTOMATION' | 'DECISION' | 'AI_AGENT', required
        - `agent_config` AgentConfig — Configuration for AI Agent to run
          - `agent_id` string, required — Id of the configured AI Agent to run
  - `edges` Edge[], required
    - `id` string, required
    - `from_id` string, required
    - `to_id` string, nullable
    - `condition_id` string
    - `none_met` boolean — Indicates a default case for a decision task. Only decision task edges can have this field and the flow advances using this edge if no conditions are met.
  - `closing_reasons` ClosingReason[]
    - `id` string
    - `title` string
    - `status` 'ACTIVE' | 'INACTIVE'
    - `lastUpdateTime` string
    - `creationTime` string
  - `entity_sync` EntitySync[]
    - `trigger` object, required — Trigger configuration that determines when entity sync occurs. Contains the event type and optional filter to target specific tasks/phases.
      - `event` 'FlowStarted' | 'FlowCompleted' | 'FlowCancelled' | 'FlowReopened' | 'FlowDeleted' | 'FlowAssigned' | 'FlowDueDateChanged' | 'FlowContextsChanged' | 'TaskUpdated' | 'CurrTaskChanged' | 'TaskCompleted' | 'TaskSkipped' | 'TaskMarkedInProgress' | 'TaskMarkedOnHold' | 'PhaseUpdated' | 'PhaseCompleted' | 'PhaseSkipped' | 'PhaseMarkedInProgress', required — Event or condition that triggers the entity sync. Direct triggers match EventBridge event names (PascalCase). Status triggers are deduced from event + entity status combination.
      - `filter` object — Optional filter to target specific tasks or phases. Specify either task_template_id OR phase_template_id (mutually exclusive). If omitted, trigger applies to all tasks/phases.
        - `task_template_id` string — Target a specific task by its template ID (stable across executions)
        - `phase_template_id` string — Target a specific phase by its template ID (stable across executions)
    - `value` object, required
      - `source` 'workflow_name' | 'workflow_status' | 'workflow_assigned_to' | 'task_name' | 'task_status' | 'task_assigned_to' | 'phase_name' | 'phase_status' | 'phase_assigned_to' | 'custom_value', required
      - `value` string
    - `target` object, required
      - `entitySchema` string, required
      - `entityAttribute` string, required
  - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
  - `singleClosingReasonSelection` boolean — Whether only a single closing reason can be selected
  - `_manifest` string[] — The manifest IDs associated with this workflow
  - `linear` boolean — When true, this is a linear flow: task enablement is computed at runtime from the graph — a task is enabled only when all of its direct predecessor tasks in its branch are done. This fully overrides any explicit per-task requirements.
  - `limit_warnings` FlowLimitWarning[] — Non-blocking warnings for configuration limits the flow exceeds. Returned on read (get-flow) and on create/update responses. Size/count limits are soft: a flow exceeding them is still accepted and stored, and the violations are reported here so the UI can surface an informational banner. The flow is still fully editable and usable.
    - `i18nKey` string, required — i18n key identifying the exceeded limit (e.g. errors.task_max_incoming_edges).
    - `message` string, required — Human-readable description of the exceeded limit.
    - `max` number, required — The configured maximum for this limit.
    - `current` number — The actual value the flow currently has for this limit (e.g. the actual number of incoming connections).
    - `node_id` string — ID of the task/node the limit applies to, when applicable.
    - `task_name` string
    - `branch_name` string
    - `param_name` string — Name of the AI-agent parameter the limit applies to, when applicable.
    - `path` unknown[], required — JSON path within the flow to the offending value.
      - unknown
  - `keep_task_automations_in_sync` boolean — Persisted preference for how the flow's task automations relate to the flow's `enabled` state. When `true`, task automations always mirror the flow: their enabled state is re-synced on every update and new task automations are created with the flow's current enabled state. When `false`, task automations are managed independently: updates never change their enabled state and new task automations are always created enabled, so a flow that is built or edited while disabled does not accumulate automations that stay off after the flow is re-enabled. When unset, legacy behavior applies: new task automations inherit the flow's enabled state and updates leave existing ones untouched. Safety: on updates that do NOT change `enabled`, the in-sync mode never re-enables automations that were disabled by the system (e.g. infinite-loop protection) — only a deliberate `enabled` flip on the flow re-arms those.

## Response `200`

Flow template has been updated successfully

- FlowTemplate — Base schema for V2 flow templates. A flow template defines the structure of a workflow including phases, tasks, edges, triggers, and other configuration. Flow templates serve as blueprints that can be instantiated as flow executions.
  - `id` string — Unique identifier for the flow template, generated by the system.
  - `org_id` string — Organization identifier that owns this flow template.
  - `name` string, required — Display name for the workflow, shown to users in the UI.
  - `description` string — Optional detailed description of the workflow's purpose and behavior.
  - `trigger` union
    - ManualTrigger
      - `id` string
      - `type` 'manual', required
      - `entity_schema` string
    - AutomationTrigger
      - `id` string
      - `type` 'automation', required
      - `automation_id` string — Id of the automation config that triggers this workflow
      - `input_entity` 'thread' | 'first_email' | 'last_email' — For email thread triggers, specifies which entity from the triggered email thread to use as the primary input for automation and decision tasks. Defaults to `thread` when not specified.
      - `trigger_config` object[] — Transient field. Trigger configurations for creating or updating the trigger automation flow. Each item follows the automation API trigger schema. Processed by the backend during create/update and stripped before storage.
        - `type` string, required — The trigger type (e.g. entity_operation, activity)
        - `configuration` object — Trigger-specific configuration
    - JourneySubmissionTrigger
      - `id` string
      - `type` 'journey_submission', required
      - `journey_id` string, required — ID of the journey that will trigger this flow
      - `journey_name` string — Name of the journey that will trigger this flow
      - `automation_id` string
    - JourneyAutomationTrigger
      - `id` string
      - `type` 'journey_automation', required
      - `entity_schema` string — Schema of the main entity where flow will be triggered. The entity will be picked from automation context.
  - `enabled` boolean — Whether the workflow is enabled or not
  - `version` 'v1' | 'v2' | 'v3' — Version of the workflow schema. - `v1` – *Deprecated*. The initial version of workflows with limited structure and automation capabilities. - `v2` – Linear workflows. Supports sequential task execution with basic automation triggers. - `v3` – Advanced workflows. Adds support for branching logic (conditions), parallel paths, and enhanced automation features such as dynamic triggers and flow control.
  - `created_at` string — ISO String Date & Time
  - `updated_at` string — ISO String Date & Time
  - `due_date` string
  - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
    - `duration` number, required
    - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
    - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
    - `task_id` string
    - `phase_id` string
  - `assigned_to` union[]
    - union
      - string
      - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
        - `variable` string, required — The variable expression, e.g., "{{entity.owner}}"
        - `value` string[] — The resolved values after variable evaluation (populated during execution)
  - `available_in_ecp` boolean — Indicates whether this workflow is available for End Customer Portal or not. By default it's not.
  - `additional_triggers` Trigger[] — Additional trigger configurations that can also start this flow. Useful for flows that should be startable via multiple methods (e.g., both automation AND manual).
    - union
      - ManualTrigger
        - `id` string
        - `type` 'manual', required
        - `entity_schema` string
      - AutomationTrigger
        - `id` string
        - `type` 'automation', required
        - `automation_id` string — Id of the automation config that triggers this workflow
        - `input_entity` 'thread' | 'first_email' | 'last_email' — For email thread triggers, specifies which entity from the triggered email thread to use as the primary input for automation and decision tasks. Defaults to `thread` when not specified.
        - `trigger_config` object[] — Transient field. Trigger configurations for creating or updating the trigger automation flow. Each item follows the automation API trigger schema. Processed by the backend during create/update and stripped before storage.
          - `type` string, required — The trigger type (e.g. entity_operation, activity)
          - `configuration` object — Trigger-specific configuration
      - JourneySubmissionTrigger
        - `id` string
        - `type` 'journey_submission', required
        - `journey_id` string, required — ID of the journey that will trigger this flow
        - `journey_name` string — Name of the journey that will trigger this flow
        - `automation_id` string
      - JourneyAutomationTrigger
        - `id` string
        - `type` 'journey_automation', required
        - `entity_schema` string — Schema of the main entity where flow will be triggered. The entity will be picked from automation context.
  - `phases` Phase[]
    - `id` string, required
    - `name` string, required
    - `due_date` string
    - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
      - `duration` number, required
      - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
      - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
      - `task_id` string
      - `phase_id` string
    - `assigned_to` union[]
      - union
        - string
        - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
          - `variable` string, required — The variable expression, e.g., "{{entity.owner}}"
          - `value` string[] — The resolved values after variable evaluation (populated during execution)
    - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
  - `tasks` Task[], required
    - union
      - ManualTask
        - `id` string, required
        - `name` string, required
        - `description` StepDescription — Longer information regarding Task
          - `enabled` boolean
          - `value` string
        - `journey` StepJourney
          - `id` string
          - `journeyId` string
          - `name` string
          - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `due_date` string
        - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
          - `duration` number, required
          - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
          - `task_id` string
          - `phase_id` string
        - `requirements` EnableRequirement[] — requirements that need to be fulfilled in order to enable the task while flow instances are running
          - `task_id` string — The id of the task that it points to
          - `phase_id` string — The id of the phase that it points to
          - `when` 'TASK_FINISHED' | 'PHASE_FINISHED', required
        - `assigned_to` union[]
          - union
            - string
            - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
              - …
        - `ecp` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `installer` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `partner` PartnerDetails — Details regarding partner for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
        - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
        - `phase_id` string
        - `task_type` 'MANUAL' | 'AUTOMATION' | 'DECISION' | 'AI_AGENT', required
      - AutomationTask
        - `id` string, required
        - `name` string, required
        - `description` StepDescription — Longer information regarding Task
          - `enabled` boolean
          - `value` string
        - `journey` StepJourney
          - `id` string
          - `journeyId` string
          - `name` string
          - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `due_date` string
        - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
          - `duration` number, required
          - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
          - `task_id` string
          - `phase_id` string
        - `requirements` EnableRequirement[] — requirements that need to be fulfilled in order to enable the task while flow instances are running
          - `task_id` string — The id of the task that it points to
          - `phase_id` string — The id of the phase that it points to
          - `when` 'TASK_FINISHED' | 'PHASE_FINISHED', required
        - `assigned_to` union[]
          - union
            - string
            - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
              - …
        - `ecp` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `installer` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `partner` PartnerDetails — Details regarding partner for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
        - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
        - `phase_id` string
        - `task_type` 'MANUAL' | 'AUTOMATION' | 'DECISION' | 'AI_AGENT', required
        - `automation_config` AutomationConfig, required — Configuration for automation execution to run
          - `flow_id` string — Id of the configured automation to run
          - `action_config` object — Transient field. The full automation action configuration following the automation API action schema. Processed by the backend during create/update and stripped before storage. When present without a flow_id, a new automation flow is created. When present with a flow_id, the existing automation flow is updated.
            - `type` string, required — The action type (e.g. send-email, trigger-workflow)
            - `config` object — Action-specific configuration
          - `duplicated_flow_id` string — Transient field. When present, the backend clones the automation flow referenced by this ID and assigns the new flow_id to the task. Used when duplicating an automation task to give it an independent automation. Stripped before storage.
          - `input_context` AutomationInputContext — Optional. Source of the entity fed into this automation task. If omitted, the workflow's primary entity is used.
            - `source` 'trigger' | 'task', required — `trigger` = workflow's primary (trigger) entity. `task` = entity produced by an upstream task in the graph.
            - `task_id` string — Required when source is `task`. The id of the upstream task whose output entity should feed this task.
        - `trigger_mode` 'manual' | 'automatic'
        - `schedule` union
          - ImmediateSchedule
            - `mode` 'immediate'
          - DelayedSchedule
            - `mode` 'delayed', required
            - `duration` number, required
            - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - RelativeSchedule
            - `mode` 'relative', required
            - `direction` 'before' | 'after', required
            - `duration` number, required
            - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
            - `reference` object, required
              - …
        - `created_automatically` boolean — Indicates whether this task was created automatically by journeys or manually by an user
      - DecisionTask
        - `id` string, required
        - `name` string, required
        - `description` StepDescription — Longer information regarding Task
          - `enabled` boolean
          - `value` string
        - `journey` StepJourney
          - `id` string
          - `journeyId` string
          - `name` string
          - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `due_date` string
        - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
          - `duration` number, required
          - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
          - `task_id` string
          - `phase_id` string
        - `requirements` EnableRequirement[] — requirements that need to be fulfilled in order to enable the task while flow instances are running
          - `task_id` string — The id of the task that it points to
          - `phase_id` string — The id of the phase that it points to
          - `when` 'TASK_FINISHED' | 'PHASE_FINISHED', required
        - `assigned_to` union[]
          - union
            - string
            - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
              - …
        - `ecp` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `installer` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `partner` PartnerDetails — Details regarding partner for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
        - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
        - `phase_id` string
        - `task_type` 'MANUAL' | 'AUTOMATION' | 'DECISION' | 'AI_AGENT', required
        - `trigger_mode` 'manual' | 'automatic', required
        - `conditions` Condition[], required
          - `id` string, required
          - `branch_name` string, required — The name of the branch
          - `logical_operator` 'AND' | 'OR', required
          - `statements` Statement[], nullable, required
            - `id` string, required
            - `source` EvaluationSource, required
              - …
            - `operator` 'equals' | 'not_equals' | 'any_of' | 'none_of' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with' | 'greater_than' | 'less_than' | 'greater_than_or_equals' | 'less_than_or_equals' | 'is_empty' | 'is_not_empty', required
            - `values` string[], required
            - `value_type` 'static' | 'relative_date' — How to interpret values. "static" (default) means literal values. "relative_date" means values[0] is a dynamic date token like "today".
        - `allow_parallel_execution` boolean — When true, all branches with met conditions execute in parallel. When false, only the first branch with a met condition is executed. Defaults to true for backwards compatibility.
        - `schedule` union
          - DelayedSchedule
            - `mode` 'delayed', required
            - `duration` number, required
            - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - RelativeSchedule
            - `mode` 'relative', required
            - `direction` 'before' | 'after', required
            - `duration` number, required
            - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
            - `reference` object, required
              - …
        - `loop_config` object
          - `loop_branch_id` string, required — The id of the branch that will be looped
          - `exit_branch_id` string, required — The id of the branch that will be used to exit the loop
          - `max_iterations` integer, required — Maximum number of iterations for the loop branch
      - AiAgentTask
        - `id` string, required
        - `name` string, required
        - `description` StepDescription — Longer information regarding Task
          - `enabled` boolean
          - `value` string
        - `journey` StepJourney
          - `id` string
          - `journeyId` string
          - `name` string
          - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `due_date` string
        - `due_date_config` DueDateConfig — Set due date for the task based on a dynamic condition
          - `duration` number, required
          - `unit` 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years', required
          - `type` 'WORKFLOW_STARTED' | 'TASK_FINISHED' | 'PHASE_FINISHED' | 'A_PRECEDING_TASK_COMPLETED' | 'ALL_PRECEDING_TASKS_COMPLETED', required
          - `task_id` string
          - `phase_id` string
        - `requirements` EnableRequirement[] — requirements that need to be fulfilled in order to enable the task while flow instances are running
          - `task_id` string — The id of the task that it points to
          - `phase_id` string — The id of the phase that it points to
          - `when` 'TASK_FINISHED' | 'PHASE_FINISHED', required
        - `assigned_to` union[]
          - union
            - string
            - VariableAssignment — Represents a variable assignment with its expression and optional resolved value. Used for dynamic user assignments that get resolved during workflow execution.
              - …
        - `ecp` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `installer` ECPDetails — Details regarding ECP for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
          - `journey` StepJourney
            - `id` string
            - `journeyId` string
            - `name` string
            - `complete_task_automatically` boolean — If true, the task be auto completed when the journey is completed. By default it is true.
        - `partner` PartnerDetails — Details regarding partner for the workflow step
          - `enabled` boolean
          - `label` string
          - `description` string
        - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
        - `phase_id` string
        - `task_type` 'MANUAL' | 'AUTOMATION' | 'DECISION' | 'AI_AGENT', required
        - `agent_config` AgentConfig — Configuration for AI Agent to run
          - `agent_id` string, required — Id of the configured AI Agent to run
  - `edges` Edge[], required
    - `id` string, required
    - `from_id` string, required
    - `to_id` string, nullable
    - `condition_id` string
    - `none_met` boolean — Indicates a default case for a decision task. Only decision task edges can have this field and the flow advances using this edge if no conditions are met.
  - `closing_reasons` ClosingReason[]
    - `id` string
    - `title` string
    - `status` 'ACTIVE' | 'INACTIVE'
    - `lastUpdateTime` string
    - `creationTime` string
  - `entity_sync` EntitySync[]
    - `trigger` object, required — Trigger configuration that determines when entity sync occurs. Contains the event type and optional filter to target specific tasks/phases.
      - `event` 'FlowStarted' | 'FlowCompleted' | 'FlowCancelled' | 'FlowReopened' | 'FlowDeleted' | 'FlowAssigned' | 'FlowDueDateChanged' | 'FlowContextsChanged' | 'TaskUpdated' | 'CurrTaskChanged' | 'TaskCompleted' | 'TaskSkipped' | 'TaskMarkedInProgress' | 'TaskMarkedOnHold' | 'PhaseUpdated' | 'PhaseCompleted' | 'PhaseSkipped' | 'PhaseMarkedInProgress', required — Event or condition that triggers the entity sync. Direct triggers match EventBridge event names (PascalCase). Status triggers are deduced from event + entity status combination.
      - `filter` object — Optional filter to target specific tasks or phases. Specify either task_template_id OR phase_template_id (mutually exclusive). If omitted, trigger applies to all tasks/phases.
        - `task_template_id` string — Target a specific task by its template ID (stable across executions)
        - `phase_template_id` string — Target a specific phase by its template ID (stable across executions)
    - `value` object, required
      - `source` 'workflow_name' | 'workflow_status' | 'workflow_assigned_to' | 'task_name' | 'task_status' | 'task_assigned_to' | 'phase_name' | 'phase_status' | 'phase_assigned_to' | 'custom_value', required
      - `value` string
    - `target` object, required
      - `entitySchema` string, required
      - `entityAttribute` string, required
  - `taxonomies` string[] — Taxonomy ids that are associated with this workflow and used for filtering
  - `singleClosingReasonSelection` boolean — Whether only a single closing reason can be selected
  - `_manifest` string[] — The manifest IDs associated with this workflow
  - `linear` boolean — When true, this is a linear flow: task enablement is computed at runtime from the graph — a task is enabled only when all of its direct predecessor tasks in its branch are done. This fully overrides any explicit per-task requirements.
  - `limit_warnings` FlowLimitWarning[] — Non-blocking warnings for configuration limits the flow exceeds. Returned on read (get-flow) and on create/update responses. Size/count limits are soft: a flow exceeding them is still accepted and stored, and the violations are reported here so the UI can surface an informational banner. The flow is still fully editable and usable.
    - `i18nKey` string, required — i18n key identifying the exceeded limit (e.g. errors.task_max_incoming_edges).
    - `message` string, required — Human-readable description of the exceeded limit.
    - `max` number, required — The configured maximum for this limit.
    - `current` number — The actual value the flow currently has for this limit (e.g. the actual number of incoming connections).
    - `node_id` string — ID of the task/node the limit applies to, when applicable.
    - `task_name` string
    - `branch_name` string
    - `param_name` string — Name of the AI-agent parameter the limit applies to, when applicable.
    - `path` unknown[], required — JSON path within the flow to the offending value.
      - unknown
  - `keep_task_automations_in_sync` boolean — Persisted preference for how the flow's task automations relate to the flow's `enabled` state. When `true`, task automations always mirror the flow: their enabled state is re-synced on every update and new task automations are created with the flow's current enabled state. When `false`, task automations are managed independently: updates never change their enabled state and new task automations are always created enabled, so a flow that is built or edited while disabled does not accumulate automations that stay off after the flow is re-enabled. When unset, legacy behavior applies: new task automations inherit the flow's enabled state and updates leave existing ones untouched. Safety: on updates that do NOT change `enabled`, the in-sync mode never re-enables automations that were disabled by the system (e.g. infinite-loop protection) — only a deliberate `enabled` flip on the flow re-arms those.

## Other responses

- `400` — Validation errors - request body contains invalid data
- `401` — Authentication failed - invalid or missing Bearer token
- `404` — Flow template not found
- `409` — Conflict - the workflow was modified by another user since it was last loaded
- `500` — Internal server error

---

[API](https://skmtc.net/epilot/apis/workflows-definitions.md) · [All operations](https://skmtc.net/epilot/apis/workflows-definitions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/workflows-definitions/versions/74e4de17e9b5/schema)