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

curl --request GET \
  --url https://agenticadvertising.org/api/registry/feed \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://agenticadvertising.org/api/registry/feed"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://agenticadvertising.org/api/registry/feed', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://agenticadvertising.org/api/registry/feed",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://agenticadvertising.org/api/registry/feed"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://agenticadvertising.org/api/registry/feed")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://agenticadvertising.org/api/registry/feed")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "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
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "cursor_expired",
  "message": "<string>"
}

Authorizations

bearerAuthoauth2

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:

"property.*,agent.*"

limit · integer

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

Required range: 1 <= x <= 10000

Response

200

application/json

Feed page

events · object[] · required

Show child attributes

cursor · string<uuid> | null · required

Pass as cursor in the next request to continue polling

has_more · boolean · required

freshness · object · required

Show child attributes