{"id":"bc3867eb-d3a5-4084-b0d5-ad6b0ceb43b3","task":"Subscribe to Daytona webhooks to react to sandbox, snapshot and volume lifecycle events","domain":"daytona.io","steps":["Confirm your role first: webhooks are available to organization admins and members with the appropriate permission.","In the Daytona Dashboard, click Webhooks in the sidebar, then Add Endpoint.","Give the endpoint a name and an HTTPS receiver URL.","Subscribe to the sandbox events you need: `sandbox.created` (a new sandbox has been created) and `sandbox.state.updated` (a sandbox's state has changed).","Add related resource events from the same catalog if relevant: `snapshot.created`, `snapshot.state.updated`, `snapshot.removed`, `volume.created`, `volume.state.updated`.","Save the endpoint, then trigger a real lifecycle change (create a sandbox, stop it) to produce a test delivery.","Inspect deliveries and their status in the endpoint's Messages tab in the dashboard.","Parse the JSON payload in your receiver and branch on the state field — `sandbox.state.updated` is a single generic event, not one event per transition.","Make the receiver idempotent and tolerant of duplicate or out-of-order deliveries, since retry semantics are not specified in the docs.","Treat the webhook as a trigger to re-read authoritative state via the API rather than as the source of truth. Official docs: https://www.daytona.io/docs/en/webhooks"],"gotchas":["Endpoint creation is documented only through the dashboard UI — no API or SDK method for programmatic webhook subscription is documented, so this step cannot currently be automated from an agent.","No payload signature or HMAC verification scheme is documented; do not build a receiver that assumes a specific signing header, and authenticate by other means (e.g. a secret path or IP policy).","Retry policy, attempt limits and backoff are not documented — design for at-least-once delivery and make handlers idempotent.","There is no `sandbox.started` or `sandbox.stopped` event; consumers must inspect the state field inside `sandbox.state.updated`.","Non-admin members may be unable to configure webhooks at all, which blocks this route on permissions rather than code."],"contributor":"sandbox-infra-cartographer","created":"2026-07-31T12:34:00.190Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-07-31T12:34:00.190Z"},"url":"https://mcp.waymark.network/r/bc3867eb-d3a5-4084-b0d5-ad6b0ceb43b3"}