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
This event fires when a new task is initiated — either via the Initiate Workflow API or through the Chamelio web application. The task is at its first step and awaiting action.
Payload Example
{
"event": "flows.tasks.created",
"event_id": "evt_01HXYZ7788990011",
"organization_id": "org_abc123",
"timestamp": "2025-06-06T08:00:00Z",
"data": {
"task_id": "task_def456",
"workflow_id": "wf_contract_review",
"workflow_name": "Contract Review",
"workflow_version": 3,
"initiated_by": "john.doe@example.com",
"current_step": {
"step_id": "step_1",
"step_name": "Initial Review",
"assignee": "reviewer@example.com"
},
"variables": {
"contract_name": "Vendor Agreement Q3",
"counterparty": "Acme Corp"
}
}
}
Payload Fields
Envelope
| Field | Type | Description |
|---|
event | string | Always flows.tasks.created |
event_id | string | Unique delivery ID — use to deduplicate retries |
organization_id | string | ID of the organization |
timestamp | string | ISO 8601 UTC timestamp of the event |
data | object | Event-specific payload (see below) |
Data Object
| Field | Type | Description |
|---|
task_id | string | Unique identifier of the new task |
workflow_id | string | ID of the workflow this task was initiated from |
workflow_name | string | Human-readable workflow name |
workflow_version | integer | Workflow version used for this task |
initiated_by | string | Email of the user who initiated the task |
current_step | object | Details of the first step (see below) |
variables | object | Input variables provided at task initiation |
Step Object
| Field | Type | Description |
|---|
step_id | string | Unique identifier of the step |
step_name | string | Human-readable step name |
assignee | string | Email of the user assigned to this step |
