flows.workflow.new_version - Chamelio Documentation

Event

flows.workflow.new_version

This event fires when a workflow is published with a new version from the Chamelio workflow builder. It concerns the workflow definition itself, not any running task.

Payload Example

{
  "event": "flows.workflow.new_version",
  "event_id": "3f7c1a8e-5b2d-4e9a-9c31-8a6f0d4b7e12",
  "organization_id": 42,
  "user_id": 1337,
  "payload_version": 1,
  "timestamp": "2026-09-02T14:32:00Z",
  "data": {
    "workflow_id": "wf_contract_review",
    "workflow_name": "Contract Review",
    "workflow_version": 4
  }
}

Payload Fields

Envelope

Field	Type	Description
`event`	string	Always `flows.workflow.new_version`
`event_id`	string	UUID for this delivery. Use it to deduplicate retries
`organization_id`	integer	ID of the organization the event occurred in
`user_id`	integer or null	ID of the user who published the version
`payload_version`	integer	Envelope schema version. Currently `1`
`timestamp`	string	ISO 8601 UTC timestamp of when the event was generated
`data`	object	Event-specific payload (see below)

Data Object

Field	Type	Description
`workflow_id`	string	ID of the workflow that was published
`workflow_name`	string	Human-readable workflow name
`workflow_version`	integer	The newly published version number

Tasks already running continue on the version they started with. Use Get Workflow Schema to read the new version’s input variables.