Webhooks

Receive real-time notifications for events.

Last updated: January 15, 2025

Setting Up Webhooks

POST /v1/webhooks
{
  "url": "https://your-server.com/webhook",
  "events": ["command.completed", "trigger.fired", "error"],
  "secret": "whsec_..."  // for signature verification
}

Available Events

Name	Type	Required	Description
`command.completed`	`event`	Optional	When a command finishes
`command.failed`	`event`	Optional	When a command fails
`trigger.fired`	`event`	Optional	When a trigger activates
`approval.required`	`event`	Optional	When user approval needed