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.tasks.completed
This event fires when a task reaches its final step and is marked as completed. All documents, signatures, and outputs are finalized at this point.

Payload Example

{
  "event": "flows.tasks.completed",
  "event_id": "evt_01HXYZ9900112233",
  "organization_id": "org_abc123",
  "timestamp": "2025-06-07T14:00:00Z",
  "data": {
    "task_id": "task_def456",
    "workflow_id": "wf_contract_review",
    "workflow_name": "Contract Review",
    "initiated_by": "john.doe@example.com",
    "completed_at": "2025-06-07T14:00:00Z",
    "duration_hours": 29.5,
    "variables": {
      "contract_name": "Vendor Agreement Q3",
      "counterparty": "Acme Corp"
    },
    "outputs": {
      "signed_document_id": "file_signed_xyz789"
    }
  }
}

Payload Fields

Envelope

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

Data Object

FieldTypeDescription
task_idstringUnique identifier of the completed task
workflow_idstringID of the parent workflow
workflow_namestringHuman-readable workflow name
initiated_bystringEmail of the user who initiated the task
completed_atstringISO 8601 UTC timestamp of task completion
duration_hoursnumberTotal time from task creation to completion, in hours
variablesobjectInput variables provided at task initiation
outputsobjectKey outputs generated by the task (e.g., signed document IDs)

Notes

Use this event to trigger post-completion actions in your systems — such as archiving signed documents, updating a CRM record, or notifying stakeholders.