Skip to main content

​
Event format

Events follow an object.action naming convention. The data field contains the full resource object as documented in the API reference, captured at the time of the event. 
{
  "id": "evt_a1b2c3d4...",
  "object": "event",
  "type": "connection.connected",
  "data": {
    "id": "conn_a1b2c3d4...",
    "object": "connection",
    "status": "connected",
    "source_id": "src_a1b2c3d4...",
    "auth_method": "username_password"
  },
  "created_at": "2025-01-15T09:30:00Z",
  "request_id": "req_a1b2c3d4..."
}

​
Agent events

TypeFired when
agent.createdAn agent is created
agent.updatedAn agent is updated
agent.deletedAn agent is deleted

​
Source events

TypeFired when
source.createdA source is created
source.updatedA source is updated
source.deletedA source is deleted

​
Connection events

TypeFired when
connection.connectingAuthentication attempt starts
connection.connectedAuthentication succeeds
connection.invalidCredentials were rejected by the source
connection.disconnectedConnection closes
connection.terminatedConnection was explicitly terminated
connection.interaction_requiredUser input is needed to continue

​
Task events

TypeFired when
task.createdA task is created
task.updatedA task definition is updated
task.deletedA task is deleted

​
Task run events

TypeFired when
task_run.queuedRun is waiting to start
task_run.runningExecution begins
task_run.pendingRun requires human approval or review before completing
task_run.completedRun finishes successfully
task_run.failedRun encounters an error
task_run.canceledRun is canceled
task_run.interaction_requiredUser input is needed during execution

​
Storage events

TypeFired when
storage.createdA file is stored during a task run
storage.deletedA storage item is deleted

​
Workflow run events

TypeFired when
workflow_run.queuedWorkflow run is waiting to start
workflow_run.runningWorkflow run is executing a step
workflow_run.sleepingWorkflow run is paused between steps
workflow_run.completedAll steps finished successfully
workflow_run.failedA step failed and the workflow stopped
workflow_run.canceledWorkflow run was manually stopped
workflow_run.interaction_requiredA step needs user input

​
Event destination events

TypeFired when
event_destination.activatedA destination passes verification and becomes active
event_destination.deactivatedA destination is disabled by the user or by failed deliveries