Registry change feed
curl --request GET \
--url https://agenticadvertising.org/api/registry/feed \
--header 'Authorization: Bearer <token>'{
"events": [
{
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type": "property.created",
"entity_type": "property",
"entity_id": "<string>",
"payload": {},
"actor": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}
],
"cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"has_more": true,
"freshness": {
"generated_at": "2023-11-07T05:31:56Z",
"latest_event_created_at": "2023-11-07T05:31:56Z",
"lag_seconds": 1,
"retention_days": 123
}
}Change Feed
Registry change feed
Poll a cursor-based feed of registry changes. Events are ordered by UUID v7 event_id for monotonic cursor progression. The feed retains events for 90 days. The freshness object reports when the response was generated, the newest matching event currently visible to the feed, and the resulting feed lag.
Type filtering supports glob patterns: property.* matches property.created, property.updated, etc.
GET
/
api
/
registry
/
feed
Registry change feed
curl --request GET \
--url https://agenticadvertising.org/api/registry/feed \
--header 'Authorization: Bearer <token>'{
"events": [
{
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"event_type": "property.created",
"entity_type": "property",
"entity_id": "<string>",
"payload": {},
"actor": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}
],
"cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"has_more": true,
"freshness": {
"generated_at": "2023-11-07T05:31:56Z",
"latest_event_created_at": "2023-11-07T05:31:56Z",
"lag_seconds": 1,
"retention_days": 123
}
}Authorizations
bearerAuthoauth2
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-serverand the protected-resource metadata at/.well-known/oauth-protected-resource/api.
Query Parameters
Resume after this event ID
Comma-separated event type filters with glob support (e.g. property.*)
Example:
"property.*,agent.*"
Max events per page (default 100, max 10,000)
Required range:
1 <= x <= 10000Was this page helpful?
⌘I