Skip to main content

​
Event format

Events follow an object.action naming convention. The data field contains a summary of the resource at the time of the event. 
{
  "id": "evt_a1b2c3d4...",
  "object": "event",
  "type": "credential.verified",
  "data": {
    "id": "cred_a1b2c3d4...",
    "object": "credential",
    "status": "verified",
    "source_id": "src_a1b2c3d4...",
    "auth_method": "username_password"
  },
  "created_at": "2025-01-15T09:30:00Z"
}

​
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

​
Credential events

TypeFired when
credential.createdA new credential is created with unverified status
credential.unverifiedA previously verified credential was updated and reverted to unverified
credential.verifiedCredential successfully authenticated for the first time
credential.invalidCredentials were rejected by the source
credential.deletedCredential was permanently removed from the vault

​
Session events

TypeFired when
session.queuedSession is waiting to be provisioned
session.runningSession is active and executing
session.idleNo active tasks, session is waiting for new work
session.completingWork is done, session is shutting down
session.completedSession finished and was closed
session.failedSession encountered an error

​
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.cancelingCancellation requested, agent is stopping
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

​
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