Skip to main content
GET
List subscriptions

Authorizations

Authorization
string
header
required

A bearer JWT issued by plugin-auth (lib-auth). The tenant identity is resolved from the validated token claims; the /v1 surface never reads a tenant from the body, path, or query. Machine callers obtain a token via the plugin-auth client-credentials flow. The /admin surface authorizes against an operator scope and carries no tenant context.

Query Parameters

sink_kind
enum<string>

Optional filter restricting results to one sink kind. The delivery destination kind. webhook posts signed HTTPS requests; pull exposes an inbox read over GET /v1/events; sqs, rabbitmq, and eventbridge fan out to the named queue or bus.

Available options:
webhook,
pull,
sqs,
rabbitmq,
eventbridge
limit
integer

Page size, clamped to a server maximum. A non-positive value uses the server default.

after
string

Keyset cursor — the id of the last row from the previous page (subscriptions are ordered DESC by id).

Response

A page of subscriptions.

subscriptions
object[]
required
next_cursor
string
required

Keyset cursor for the next page (the id of the last row). Non-empty only on a full page; an empty string marks the final page.

Example:

"0192f1a0-0000-7000-8000-00000000c002"