Saltar al contenido principal
GET
Haz pull de los eventos a los que tienes derecho

Autorizaciones

Authorization
string
header
requerido

Un JWT bearer emitido por plugin-auth (lib-auth). La identidad del tenant se resuelve a partir de los claims validados del token; la superficie /v1 nunca lee un tenant del cuerpo, del path ni de la query. Los llamadores de máquina obtienen un token vía el flujo client-credentials de plugin-auth. La superficie /admin autoriza contra un scope de operador y no lleva contexto de tenant.

Parámetros de consulta

subscription_id
string<uuid>
requerido

The pull subscription to read. Resolved through an existence gate then a kind gate: an absent, cross-tenant, or non-pull id all return a uniform 404 not_found (no existence or kind oracle).

after
integer<int64>

Explicit keyset cursor (replay). When present it overrides the persisted cursor for the read; absent it, the read resumes from the persisted acknowledged seq (0 = from the beginning). A malformed value is ignored and folds to the persisted cursor.

limit
integer

Page size, clamped to the range 1–500, defaulting to 100.

Respuesta

Una página de eventos en orden ascendente de seq.

events
object[]
requerido

A page of events in ascending seq order.

next_cursor
integer<int64> | null
requerido

The maximum seq in the page when it filled exactly to limit (a possible next page); null on a short or final page. This diverges deliberately from the subscriptions list cursor (which is a DESC-by-id string with an empty-string sentinel).

Ejemplo:

42