NDNCI Docs
API v1API reference

Read webhook delivery history

Read a bounded delivery history containing status, attempt counts and redacted failure codes without secrets or request payloads.

GET/v1/webhooks/{webhookId}/deliveries

Authorization

bearerKey
AuthorizationBearer <token>

A scoped automation key authorized for the REST API.

In: header

Path Parameters

webhookId*string
Formatuuid

Header Parameters

X-Ndnci-Workspace*string

Select a workspace explicitly included in this access grant.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08/deliveries" \  -H "X-Ndnci-Workspace: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer <NDNCI_API_KEY>"
{  "success": true,  "code": "PUBLIC_WEBHOOKS_DELIVERIES",  "message": "Successful response",  "data": {    "items": [      {        "id": "123e4567-e89b-42d3-a456-426614174008",        "webhookId": "123e4567-e89b-42d3-a456-426614174007",        "eventId": "123e4567-e89b-42d3-a456-426614174006",        "status": "failed",        "attempts": 12,        "replayCount": 0,        "lastStatusCode": 503,        "lastErrorCode": "WEBHOOK_HTTP_ERROR",        "createdAt": "2026-10-01T12:00:00Z",        "deliveredAt": null      }    ]  }}

Required scope: webhooks:read · Usage points: 2

Credits are charged separately for work that consumes paid services.

Rotate a webhook secret POST

Replace the signing secret for one workspace webhook. Store the returned new secret securely; the previous secret is invalidated.

Replay a failed delivery POST

Request a bounded replay of an eligible failed delivery. The event identifier is preserved for duplicate detection; authorization and destination safety are checked again.