Skip to main content

Webhooks

OpenProxyAI can deliver events to an HTTPS endpoint you control — for example, to pipe policy blocks or budget alerts into your own alerting system.

Managing webhooks​

GET  /api/v1/organizations/current/webhooks
POST /api/v1/organizations/current/webhooks

Delivery and retries​

Webhook delivery is treated as a sidecar: a failed delivery never blocks or delays the request that triggered it. Failed deliveries are retried automatically with exponential backoff, up to 3 attempts, on a 5-minute background schedule. You can view delivery history and manually retry a specific failed delivery:

GET  /api/v1/organizations/current/webhooks/deliveries
POST /api/v1/organizations/current/webhooks/deliveries/{delivery_id}/retry

Verifying webhook authenticity​

:::info Signature verification details coming soon This page will document the signing scheme used to verify that a webhook payload genuinely came from OpenProxyAI. :::