Skip to main content
GET
Read the events feed

Authorizations

Authorization
string
header
required

An organization API key. Keys carry a role (read_write or read_only) and may be restricted to a namespace prefix such as acme/*, or to one namespace such as acme/prod/tenant_1. A prefix matches on a / boundary: acme/prod/tenant_1* covers acme/prod/tenant_1 and everything under acme/prod/tenant_1/, never acme/prod/tenant_12.

Query Parameters

cursor
string

The next_cursor of the previous page.

limit
integer
default:100

Events per page.

Required range: 1 <= x <= 1000
types
string[]

Only these event types; * after a dot matches any, as in subscription.*.

An event type such as job.completed, or a family with * after the dot, such as job.*.

Maximum string length: 64
Pattern: ^[a-z_]+\.([a-z_]+|\*)$
namespace_prefix
string

Only events of namespaces whose name starts with this prefix, such as acme/prod/.

Maximum string length: 256

Response

One page of events.

events
object[]
required
Maximum array length: 1000

An event, as pushed (the request body) and as the feed lists it: id, type, timestamp and data, discriminated on type. Types may be added, so ignore the ones you don't know.

next_cursor
string
required

Where the next page starts. Always present, even on an empty page.