Skip to main content
GET
/
api
/
registry
/
feed
/
stream
Registry change feed stream
curl --request GET \
  --url https://agenticadvertising.org/api/registry/feed/stream \
  --header 'Authorization: Bearer <token>'
"<string>"

Authorizations

Authorization
string
header
required

Bearer token in the Authorization header. Two token types are accepted:

  • Organization API key (sk_...) issued via the dashboard. Org-scoped, long-lived, for server-to-server use.
  • User JWT obtained via the OAuth 2.1 authorization code flow with PKCE. User-scoped, short-lived. Discover the authorization server at /.well-known/oauth-authorization-server and the protected-resource metadata at /.well-known/oauth-protected-resource/api.

Query Parameters

cursor
string<uuid>

Resume after this event ID

types
string

Comma-separated event type filters with glob support (e.g. property.*)

Example:

"authorization.*,publisher.adagents_changed"

limit
integer

Max events per SSE feed page (default 100, max 10,000)

Required range: 1 <= x <= 10000
poll_interval_seconds
integer

Server-side interval while caught up (default 15 seconds). Backlog pages are sent without waiting.

Required range: 5 <= x <= 60

Response

SSE stream. event: feed data validates as a registry feed page.

Server-Sent Events stream. feed events carry JSON matching the RegistryFeedPage schema; heartbeat events carry { generated_at, cursor }.