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 any participant adds a comment to a task. Comments can be added at any point during task execution and are visible to all participants.
Payload Example
{
"event": "flows.tasks.commented",
"event_id": "evt_01HXYZBB22334455",
"organization_id": "org_abc123",
"timestamp": "2025-06-06T11:05:00Z",
"data": {
"task_id": "task_def456",
"workflow_id": "wf_contract_review",
"workflow_name": "Contract Review",
"comment_id": "comment_ghi789",
"comment_text": "Please update the liability cap in section 8 before I can approve.",
"commented_by": "legal@example.com",
"current_step": {
"step_id": "step_2",
"step_name": "Legal Approval"
}
}
}
Payload Fields
Envelope
| Field | Type | Description |
|---|
event | string | Always flows.tasks.commented |
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 task |
workflow_id | string | ID of the parent workflow |
workflow_name | string | Human-readable workflow name |
comment_id | string | Unique identifier of the comment |
comment_text | string | Text content of the comment |
commented_by | string | Email of the user who posted the comment |
current_step | object | The step the task was on when the comment was posted |
Current Step Object
| Field | Type | Description |
|---|
step_id | string | Unique identifier of the step |
step_name | string | Human-readable step name |
