Delivery history

Delivery attempts for a webhook (status, latency, response code), newest first. Keyset-paginated: when hasMore is true, an RFC 5988 Link: <…?startingAfter=<id>>; rel="next" response header points at the next page.

GET/api/webhooks/{id}/deliveries

Authorization

better-auth.session_token<token>

Cookie session from Better Auth. Requires X-Org-Id header for org-scoped routes.

In: cookie

Path Parameters

id*string

Query Parameters

limit?integer

Page size. Out-of-range or non-numeric values fall back to 20.

Default20
Range1 <= value <= 100
startingAfter?string

Keyset cursor — the id of the last delivery of the previous page. Supplied by the Link: rel="next" header. An id that is not a delivery of this webhook is a 400.

Formatuuid

Header Parameters

X-Org-Id?string

Organization ID. Required for cookie auth. Not needed for API key auth (org resolved from key).

Formatuuid
X-Space-Id?string

Space ID. Required for space-scoped routes (agents, runs, schedules, and space-scoped module routes). Not needed for API key auth (space resolved from key).

curl -X GET "https://your-instance/api/webhooks/string/deliveries"
{
  "object": "list",
  "data": [
    {
      "id": "0b6f3c1e-8f0a-4c52-9d7e-2a1b3c4d5e6f",
      "eventId": "evt_cm3ghi790",
      "eventType": "run.success",
      "status": "success",
      "statusCode": 200,
      "latency": 142,
      "attempt": 1,
      "error": null,
      "createdAt": "2026-01-15T11:00:00Z"
    }
  ],
  "hasMore": false
}

{
  "type": "https://docs.appstrate.dev/errors/validation-failed",
  "title": "Validation Failed",
  "status": 400,
  "detail": "name: Invalid input: expected string, received undefined (+2 more)",
  "code": "validation_failed",
  "request_id": "req_abc123",
  "errors": [
    {
      "field": "name",
      "code": "required",
      "message": "Invalid input: expected string, received undefined"
    },
    {
      "field": "email",
      "code": "invalid_format",
      "message": "Invalid email address"
    },
    {
      "field": "age",
      "code": "invalid_type",
      "message": "Invalid input: expected number, received string"
    }
  ]
}

{
  "type": "https://docs.appstrate.dev/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Invalid or missing session",
  "code": "unauthorized",
  "request_id": "req_abc123"
}
{
  "type": "https://docs.appstrate.dev/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "Insufficient permissions",
  "code": "forbidden",
  "request_id": "req_abc123"
}
{
  "type": "https://docs.appstrate.dev/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Resource not found",
  "code": "not_found",
  "request_id": "req_abc123"
}
{
  "type": "https://docs.appstrate.dev/errors/rate-limited",
  "title": "Rate Limited",
  "status": 429,
  "detail": "Too many requests. Please try again shortly.",
  "code": "rate_limited",
  "request_id": "req_abc123",
  "retry_after": 30
}