Webhook Deliveries

View and retry webhook delivery history

List webhook deliveries

get

Retrieves paginated webhook delivery history with filtering

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Alternative: You can also use the x-api-key header instead of Authorization Bearer.

Query parameters

pageinteger · min: 1Optional

Page number for pagination (1-indexed)

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

webhook_idstring · uuidOptional

Filter by webhook ID

statusstring · enumOptional

Filter by delivery status

Possible values:

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Responses

200

Webhook delivery history

application/json

totalintegerOptional

pageintegerOptional

limitintegerOptional

total_pagesintegerOptional

401

Unauthorized - Invalid or missing API key

application/json

get

/webhook-deliveries

HTTPcURLJavaScriptPython

GET /v1/webhook-deliveries HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "bb0e8400-e29b-41d4-a716-446655440006",
      "webhook_id": "aa0e8400-e29b-41d4-a716-446655440005",
      "event_type": "call.completed",
      "status": "delivered",
      "attempt_count": 1,
      "response_status": 200,
      "created_at": "2024-01-15T10:30:00Z",
      "delivered_at": "2024-01-15T10:30:01Z"
    }
  ],
  "total": 250,
  "page": 1,
  "limit": 20,
  "total_pages": 13,
  "summary": {
    "total": 250,
    "delivered": 240,
    "failed": 8,
    "pending": 2,
    "success_rate": 96
  }
}

Get webhook delivery details

get

Retrieves full details including payload and response

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Alternative: You can also use the x-api-key header instead of Authorization Bearer.

Path parameters

idstring · uuidRequired

Webhook delivery UUID

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Responses

200

Webhook delivery details

application/json

idstring · uuidOptional

webhook_idstring · uuidOptional

event_typestringOptional

statusstring · enumOptionalPossible values:

attempt_countintegerOptional

response_statusinteger · nullableOptional

error_messagestring · nullableOptional

created_atstring · date-timeOptional

delivered_atstring · date-time · nullableOptional

next_retry_atstring · date-time · nullableOptional

webhook_urlstring · uriOptional

response_bodystring · nullableOptional

404

Resource not found

application/json

get

/webhook-deliveries/{id}

HTTPcURLJavaScriptPython

GET /v1/webhook-deliveries/{id} HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "bb0e8400-e29b-41d4-a716-446655440006",
  "webhook_id": "aa0e8400-e29b-41d4-a716-446655440005",
  "webhook_url": "https://api.example.com/webhooks/krosai",
  "event_type": "call.completed",
  "status": "delivered",
  "attempt_count": 1,
  "response_status": 200,
  "payload": {
    "event": "call.completed",
    "call_id": "880e8400-e29b-41d4-a716-446655440003",
    "duration": 120
  },
  "response_body": "{\"received\": true}",
  "created_at": "2024-01-15T10:30:00Z",
  "delivered_at": "2024-01-15T10:30:01Z"
}

Retry failed delivery

post

Manually retries a failed webhook delivery

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Alternative: You can also use the x-api-key header instead of Authorization Bearer.

Path parameters

idstring · uuidRequired

Webhook delivery UUID

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Responses

200

Retry initiated

application/json

idstring · uuidOptional

webhook_idstring · uuidOptional

event_typestringOptional

statusstring · enumOptionalPossible values:

attempt_countintegerOptional

response_statusinteger · nullableOptional

error_messagestring · nullableOptional

created_atstring · date-timeOptional

delivered_atstring · date-time · nullableOptional

next_retry_atstring · date-time · nullableOptional

webhook_urlstring · uriOptional

response_bodystring · nullableOptional

400

Delivery cannot be retried

application/json

404

Resource not found

application/json

post

/webhook-deliveries/{id}/retry

HTTPcURLJavaScriptPython

POST /v1/webhook-deliveries/{id}/retry HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "webhook_id": "123e4567-e89b-12d3-a456-426614174000",
  "event_type": "text",
  "status": "pending",
  "attempt_count": 1,
  "response_status": 1,
  "error_message": "text",
  "created_at": "2026-06-18T10:23:32.009Z",
  "delivered_at": "2026-06-18T10:23:32.009Z",
  "next_retry_at": "2026-06-18T10:23:32.009Z",
  "webhook_url": "https://example.com",
  "payload": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "response_body": "text"
}