API ReferenceWebhooks

Delete Subscription

Permanently delete a webhook subscription. Once deleted, Airweave will stop sending events to this endpoint immediately. This action cannot be undone. Any pending message deliveries will be cancelled. If you want to temporarily stop receiving events, consider disabling the subscription instead using the PATCH endpoint.

Authentication

x-api-keystring
API Key authentication via header

Path parameters

subscription_idstringRequired

The unique identifier of the subscription to delete (UUID).

Response

Deleted subscription
idstring

Unique identifier for this subscription (UUID format)

urlstring
The URL where webhook events are delivered
created_atstringformat: "date-time"

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

updated_atstringformat: "date-time"

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

filter_typeslist of strings or null
Event types this subscription is filtered to receive. See EventType enum for all available types.
disabledboolean or nullDefaults to false
Whether this subscription is currently disabled. Disabled subscriptions do not receive event deliveries.
descriptionstring or null

Optional human-readable description of this subscription

health_statusenum or null

Health status of this subscription based on recent delivery attempts. Values: ‘healthy’ (all recent deliveries succeeded), ‘degraded’ (mix of successes and failures), ‘failing’ (consecutive failures beyond threshold), ‘unknown’ (no delivery data yet).

Allowed values:

Errors