Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.envless.cloud/llms.txt

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

​
When it fires

Emitted by the delivery worker when a single delivery hits the max retry count (5) without a 2xx response. The endpoint’s consecutiveFailures counter has been incremented on each failure.
To prevent infinite recursion, a failed webhook.delivery_failed delivery does not itself emit a new webhook.delivery_failed. Loops are avoided.

​
Payload

{
    type: 'webhook.delivery_failed',
    data: {
        delivery: {
            id: string                // the failed WebhookDelivery uuid
            eventId: string           // the underlying WorkspaceEvent uuid
            eventType: string         // the event type that failed to deliver
            endpointId: string
            endpointName: string
            endpointUrl: string
            attempts: number          // always equals max attempts (5)
            responseStatus: number | null   // last HTTP status, null if request errored before response
            error: string | null      // last error message
        }
    }
}
The actor is always null — system event from the worker.

​
Example

{
    "type": "webhook.delivery_failed",
    "actor": null,
    "data": {
        "delivery": {
            "id": "0192a1b2-c3d4-7000-8000-0000000000e0",
            "eventId": "0192a1b2-c3d4-7000-8000-0000000000e1",
            "eventType": "project.created",
            "endpointId": "0192a1b2-c3d4-7000-8000-0000000000d0",
            "endpointName": "Customer receiver",
            "endpointUrl": "https://customer.example.com/webhooks",
            "attempts": 5,
            "responseStatus": 503,
            "error": "Receiver returned 503"
        }
    }
}

​
Suggested handling

  • Page on-call for important consumers
  • Auto-disable the endpoint if consecutiveFailures is unreasonably high (we don’t auto-disable; you decide based on your SLAs)
  • Notify the workspace owner via email/Slack so they can fix the receiver