List the subscriptions needing attention

Returns one keyset page of the tenant’s subscriptions that need an operator’s attention, ordered by attention rank, then most recent failure, then id. Each item carries only non-secret operational state and the period’s attempt counts: never an endpoint, credential, signing secret, or raw error. To read the next page, send next_cursor as cursor with the same from and to. Authorization checks the resource dashboard and the action get.

GET /v1/dashboard/subscriptions

List the subscriptions needing attention

cURL

curl --request GET \
  --url https://streaming-hub.sandbox.lerian.net/v1/dashboard/subscriptions \
  --header 'Authorization: Bearer <token>'

200

{
  "snapshot_at": "2026-09-11T12:00:00Z",
  "window_start": "2026-09-10T12:00:00Z",
  "window_end": "2026-09-11T12:00:00Z",
  "items": [
    {
      "subscription_id": "0192f1a0-0000-7000-8000-0000000000ff",
      "sink_kind": "webhook",
      "enabled": false,
      "verification_state": "pending_verification",
      "auto_disabled": true,
      "disabled_reason": "sustained_failure_5d12h",
      "last_success_at": "2026-09-10T09:30:00Z",
      "last_failure_at": "2026-09-11T09:29:00Z",
      "period_delivery_attempts": 12,
      "period_failed_attempts": 12,
      "period_dead_lettered_attempts": 3,
      "attention_reasons": [
        "auto_disabled",
        "dead_lettered_in_period"
      ]
    }
  ],
  "next_cursor": ""
}

Autorizaciones

Authorization · string · header · requerido

A bearer JWT issued by Access Manager. The /v1 surface never reads a tenant from the body, path, or query. Machine callers obtain a token with the Access Manager client-credentials flow. The /admin surface authorizes against an operator scope and carries no tenant context.

Parámetros de consulta

from · string<date-time>

The inclusive start of the period, an RFC 3339 instant. Required when cursor is present.

to · string<date-time>

The exclusive end of the period, an RFC 3339 instant. Required when cursor is present.

window_hours · integer

A rolling period width in whole hours, from 1 to 720, resolved against this request's own snapshot instant. It cannot be sent with from or to, and it applies to the first page only: a page with cursor repeats the first page's window_start and window_end as from and to.

limit · integer

The page size, from 1 to 50. Defaults to 20. A value out of range is rejected, not clamped.

cursor · string

The next_cursor of the previous page. It is signed and bound to the period and to the caller, so repeat from and to unchanged.

Respuesta

200

application/json

A page of subscriptions needing attention.

snapshot_at · string<date-time> · requerido

The database instant the read observed (UTC, RFC 3339).

Ejemplo:

"2026-09-11T12:00:00Z"

window_start · string<date-time> · requerido

The inclusive start of the resolved period (UTC, RFC 3339). Repeat it as from on the next page.

Ejemplo:

"2026-09-10T12:00:00Z"

window_end · string<date-time> · requerido

The exclusive end of the resolved period (UTC, RFC 3339). Repeat it as to on the next page.

Ejemplo:

"2026-09-11T12:00:00Z"

items · object[] · requerido

The page, ordered by attention rank, then last_failure_at (most recent first, never-failed last), then subscription_id. An empty page is [].

Show child attributes

next_cursor · string · requerido

The signed resume token for the next page. An empty string on the last page.

Ejemplo:

""