API ReferenceWebhooks

Webhooks API

Use webhooks to receive Pulserun events outside the dashboard.

POST /v1/webhooks

Create a webhook destination.

curl -X POST https://api-staging.pulserun.dev/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/pulserun-webhooks",
    "events": ["instance.started", "instance.terminated", "spot.preempted"]
  }'

GET /v1/webhooks

List webhooks for the current account.

PUT /v1/webhooks/{webhook_id}

Update the URL, events, secret, or active status.

DELETE /v1/webhooks/{webhook_id}

Delete a webhook registration.

Notes

Webhook delivery tracking exists, but event coverage depends on the feature area. Treat it as an integration surface for operational notifications, not a full event bus.

RecommendationsErrors & Rate Limits