Skip to content
Webhooks

List webhook deliveries

GET/api/v1alpha1/webhooks/{webhook_id}/deliveries

Returns the delivery attempts DeepFrame has made to one endpoint, newest first. This is where you look when an endpoint stops receiving events.

  • Access: an alpha-enabled API key with the MANAGE_WEBHOOKS permission.
  • Paging: limit defaults to 25, maximum 100. Pass next_cursor back unchanged as cursor.
  • Each record shows: event_id, event_type, status, attempts, next_attempt_at, and the status code of the last response when there was one. The payload and the signing secret are never included.

When an attempt has been given up on, you can queue a fresh one with POST /api/v1alpha1/webhooks/{webhook_id}/deliveries/{delivery_id}/redeliver.

AuthorizationBearer <token>

In: header

Path Parameters

webhook_id*string

Identifier of a registered webhook endpoint.

Query Parameters

cursor?string

Opaque cursor returned as next_cursor by the previous response. Pass it byte-for-byte as cursor; do not decode, edit, or construct it.

limit?number

Number of resources to return in one page. The default is 25 and the accepted range is 1-100.

Formatint32
Range1 <= value <= 100
Default25

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v1alpha1/webhooks/wh_0190b5d4-7e1f-7a2b-9c3d-1234567890ab/deliveries" \  -H "Authorization: Bearer $DEEPFRAME_API_KEY"
{  "data": [    {      "attempts": 1,      "created_at": "2026-08-08T10:00:01.000Z",      "endpoint_id": "wh_0190b5d4-7e1f-7a2b-9c3d-1234567890ab",      "event_id": "evt_0190b5d4-7e1f-7a2b-9c3d-1234567890ab",      "event_type": "video.indexed",      "id": "delivery_0190b5d4-7e1f-7a2b-9c3d-1234567890ab",      "next_attempt_at": "2026-08-08T10:05:00.000Z",      "response_status": 200,      "status": "delivered"    }  ],  "has_more": false,  "next_cursor": "MDEyMzQ1Njc4OWFitSLKnTQIcJAwDPi07V5EGs76Im3F8rCuUshrBnHuUJY7_8Ie8Stea_TKuhKhDw5XkRdkBI3IKkvsKT9Kp60Wpx7CoTCGQW8FnalDILVbuy8wxvWWf_B8SA"}