Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.chamelio.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Event

flows.workflow.new_version
This event fires when a workflow author publishes a new version of an existing workflow. New workflow initiations will use the latest published version unless a specific version is requested.

​
Payload Example

{
  "event": "flows.workflow.new_version",
  "event_id": "evt_01HXYZ5566778899",
  "organization_id": "org_abc123",
  "timestamp": "2025-06-04T10:00:00Z",
  "data": {
    "workflow_id": "wf_contract_review",
    "workflow_name": "Contract Review",
    "new_version": 3,
    "previous_version": 2,
    "published_by": "admin@example.com",
    "changelog": "Added legal approval step before final sign-off"
  }
}

​
Payload Fields

​
Envelope

FieldTypeDescription
eventstringAlways flows.workflow.new_version
event_idstringUnique delivery ID — use to deduplicate retries
organization_idstringID of the organization that owns the workflow
timestampstringISO 8601 UTC timestamp of the event
dataobjectEvent-specific payload (see below)

​
Data Object

FieldTypeDescription
workflow_idstringUnique identifier of the workflow
workflow_namestringHuman-readable workflow name
new_versionintegerVersion number of the newly published version
previous_versionintegerVersion number that was previously active
published_bystringEmail of the user who published the version
changelogstringOptional description of changes in this version

​
Notes

If you cache workflow schemas in your integration, listen for this event to invalidate your cache and fetch the updated schema via the Get Workflow Schema endpoint.