Guest Machines

Webhook events

Every subscribable webhook event, grouped by the resource it reports on.

These are the event types an outbound webhook can subscribe to. New ones are added over time, so treat the list as open — capability discovery returns the current catalog for your workspace.

The console's test action sends ping, a delivery test rather than a platform event. Your receiver should accept it and ignore it.

See Webhooks for delivery, signing, and retries.

Run progress

Follow agent runs from start to finish, including a workflow's steps.

ValueMeaning
run.startedAn agent begins working.
run.completedAn agent completes its work.
run.failedA run ends before completing its work.
run.cancelledSomeone or something stops a run.
run.pausedA run stops temporarily and can continue later.
run.resumedWork restarts after a pause.
run.requires_approvalA person must approve the next step before work continues.

Problems during runs

Know when a run needs attention.

ValueMeaning
run.tool_call.failedA tool returns an error while a run is working.
run.policy_violationA run attempts an action that a policy does not allow.

Workflows

Follow workflow runs from start to finish.

ValueMeaning
workflow.run.startedA workflow run begins its first step.
workflow.run.completedEvery step the workflow ran completed and its output was saved.
workflow.run.failedA workflow run stops because a step failed, a limit was reached, or its output didn't match its schema.
workflow.part.conflictA part of a parallel step was already being worked on, so it wasn't started a second time.

Alerts

Forward alerts as soon as their conditions are met.

ValueMeaning
alert.triggeredA configured alert condition is met.

Budgets and limits

Know before usage or spending stops important work.

ValueMeaning
budget.breach.warnSpending reaches the budget's early warning threshold.
budget.breach.criticalSpending reaches the budget's critical threshold.
budget.hard_stopA hard budget limit prevents more work from starting.
run.limit_exceededA usage or concurrency limit prevents work.

On this page