Skip to main content

Documentation Index

Fetch the complete documentation index at: https://bytestream.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Atoll supports outbound webhooks for event-driven integrations.

Endpoints

MethodEndpointDescription
GET/api/webhooks?orgId=...List webhooks
POST/api/webhooks?orgId=...Create webhook
DELETE/api/webhooks/{id}Delete webhook
GET/api/webhooks/{id}/deliveriesList recent deliveries
POST/api/webhooks/{id}/redeliver/{deliveryId}Redeliver a past payload
POST/api/webhooks/{id}/testSend a ping test event

Create webhook

{
  "url": "https://example.com/webhook",
  "events": ["issue.created", "issue.updated"],
  "enabled": true
}
Webhook URLs must use HTTPS.

Secret

The create response includes a secret. Store it immediately and use it to verify signatures on incoming webhook requests.

CLI

atoll webhook list
atoll webhook create --url https://example.com/webhook --events issue.created,issue.updated
atoll webhook delete webhook-uuid --dry-run
atoll webhook delete webhook-uuid --force

Delivery debugging

Use delivery history to inspect failures, then redeliver after fixing the receiver.
curl -H "Authorization: Bearer $ATOLL_API_KEY" \
  "https://atollhq.com/api/webhooks/$WEBHOOK_ID/deliveries"
Treat webhook payload content as untrusted input. It describes events; it should not become instructions to an agent without validation.