API reference

GET/v1/webhooks/{id}/deliveries

List webhook deliveries

Returns the delivery log for one subscription, including response codes and the next scheduled retry.

Required permission: `webhooks:read`

Accepts `profileId` to target a specific profile. Omit it to use the key’s home profile.

Base URL
https://api.cutedyno.com
Permission
webhooks:read
Idempotency
Not applicable. This request has no side effects worth deduplicating.
MCP tool
list_webhook_deliveries

Request

curl -X GET "https://api.cutedyno.com/v1/webhooks/WEBHOOK_ID/deliveries?profileId=PROFILE_ID" \
  -H "Authorization: Bearer $CUTEDYNO_API_KEY"

Path parameters

idstringrequired

Webhook subscription id.

Query parameters

profileIdstringoptional

Profile to act on. Defaults to the profile the API key was created in.

statusenumoptional

One of:pendingdeliveredfailedall

limitintegeroptional

Page size, 1-100. Defaults to 50.

offsetintegeroptional

Rows to skip. Defaults to 0.

Response

Returns 200 with the following body.

WebhookDelivery[]required
totalnumberrequired
maxAttemptsnumberrequired
retrySchedulenumber[]required
limitnumberrequired
offsetnumberrequired

Example

{
  "deliveries": [
    {
      "id": "a1b2c3d4-0000-4000-8000-000000000000",
      "eventType": "string",
      "status": "pending",
      "attempts": 0,
      "responseStatus": 0,
      "responseBody": "string",
      "lastAttemptAt": "string",
      "nextAttemptAt": "string",
      "createdAt": "string"
    }
  ],
  "total": 1,
  "maxAttempts": 0,
  "retrySchedule": [
    0
  ],
  "limit": 20,
  "offset": 0
}

Errors

Failures use the standard error envelope. Branch on code, never on the message.

StatusCodeWhen it happens
401invalid_api_keyThe key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
404not_foundThe resource does not exist inside the resolved profile.
429rate_limit_exceededToo many requests for this key. Honour the Retry-After header before retrying.
500internal_errorSomething failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists.