PLATFORM RC-79 Webhooks subscriptions + event filtering (v1.1) (contract) (v1.1)

Download OpenAPI specification:

Planning-only contract surface for webhook subscriptions and event catalog introspection. This document does not imply a runtime backend implementation.

List canonical webhook events (v1.1)

Read-only catalog introspection. Auth: requires developer/merchant auth (implementation-specific; not implemented in this RC).

query Parameters
limit
integer [ 1 .. 200 ]
cursor
string
header Parameters
X-Correlation-Id
required
string

Responses

Response samples

Content type
application/json
{
  • "events": [
    ],
  • "next_cursor": "string"
}

List webhook subscriptions (v1.1) (metadata only)

Read-only subscription introspection. Auth: requires developer/merchant auth (implementation-specific; not implemented in this RC).

query Parameters
merchant_id
string <uuid>
status
string (WebhookSubscriptionStatus)
Enum: "active" "paused" "disabled"
limit
integer [ 1 .. 200 ]
cursor
string
header Parameters
X-Correlation-Id
required
string

Responses

Response samples

Content type
application/json
{
  • "subscriptions": [
    ],
  • "next_cursor": "string"
}