v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-222763184.3 KB

webhooks

List Subscriptions

List all webhook subscriptions for your organization.

Returns all configured webhook endpoints, including their URLs, subscribed event types, and current status (enabled/disabled). Use this to audit your webhook configuration or find a specific subscription.

get/webhooks/subscriptions

Response

List of webhook subscriptions

idstring required

Unique identifier for this subscription (UUID format)

urlstring required

The URL where webhook events are delivered

filter_typesstring[] nullable

Event types this subscription is filtered to receive. See EventType enum for all available types.

disabledboolean

Whether this subscription is currently disabled. Disabled subscriptions do not receive event deliveries.

descriptionstring nullable

Optional human-readable description of this subscription

created_atstring date-time required

When this subscription was created (ISO 8601 format, UTC)

updated_atstring date-time required

When this subscription was last updated (ISO 8601 format, UTC)

health_status'healthy' | 'degraded' | 'failing' | 'unknown'

Health status of a webhook subscription based on recent delivery attempts.

Example response

[
  {
    "created_at": "2024-03-01T08:00:00Z",
    "description": "Production notifications for data team",
    "disabled": false,
    "filter_types": [
      "sync.completed",
      "sync.failed"
    ],
    "health_status": "healthy",
    "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "updated_at": "2024-03-15T14:30:00Z",
    "url": "https://api.mycompany.com/webhooks/airweave"
  }
]