For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Fork this repoGet a demo
  • Docs
    • Welcome
    • Quickstart
    • Concepts
    • Search
    • MCP Server
    • CLI
    • Agent Skills
    • Connect
    • Add New Connector
    • Rate Limits
  • API Reference
      • GETList Messages
      • GETGet Message
      • GETList Subscriptions
      • GETGet Subscription
      • POSTCreate Subscription
      • PATCHUpdate Subscription
      • POSTRecover Failed Messages
      • DELDelete Subscription
LogoLogo
Fork this repoGet a demo
API ReferenceWebhooks

List Subscriptions

GET
/webhooks/subscriptions
GET
/webhooks/subscriptions
1import requests
2
3url = "https://api.airweave.ai/webhooks/subscriptions"
4
5headers = {"x-api-key": "<apiKey>"}
6
7response = requests.get(url, headers=headers)
8
9print(response.json())
1[
2  {
3    "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
4    "url": "https://api.mycompany.com/webhooks/airweave",
5    "created_at": "2024-03-01T08:00:00Z",
6    "updated_at": "2024-03-15T14:30:00Z",
7    "filter_types": [
8      "string"
9    ],
10    "disabled": false,
11    "description": "string",
12    "health_status": "healthy"
13  }
14]

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.

Was this page helpful?
Previous

Get Subscription

Next
Built with

Authentication

x-api-keystring
API Key authentication via header

Response

List of webhook subscriptions
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.
disabledbooleanDefaults 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

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

422
Unprocessable Entity Error
429
Too Many Requests Error