Poll for updates across your team. Returns a chronological feed of events (completed requests, new guest appearances, podcasts added to projects, alert matches) since a given timestamp or cursor. Designed for regular polling — use the returned cursor for efficient subsequent calls.
This endpoint requires an API token. You can learn more about how to get an API token from the authentication page.
| Property | Type | Description |
|---|---|---|
sinceoptional | string ⓘConstraints: datetime | ISO 8601 timestamp. Return events after this point. Ignored if cursor is provided. Max lookback: 30 days. |
cursoroptional | string | Opaque cursor from a previous response. Takes precedence over since. |
eventTypesoptional | unknown | Comma-separated list of event types to include: request_completed, guest_appearance, listed_podcast_added, alert_match. Default: all. |
projectIdoptional | string | Filter listed_podcast_added events to a specific project. |
guestProfileIdoptional | string | Filter guest_appearance events to a specific guest profile. |
alertConfigIdoptional | string | Filter alert_match events to a specific alert configuration. |
limit | number ⓘConstraints: >= 1<= 100 | Max events per page (1-100, default 50). |
| Property | Type | Description |
|---|---|---|
status | literal: OK | |
options | object | The resolved options used for this query. |
└sincenullable | string ⓘConstraints: datetime | The resolved since timestamp used for this query. |
└cursornullable | string | The cursor provided in this request, if any. |
└eventTypes | array of enum ⓘAllowed values request_completedguest_appearancelisted_podcast_addedalert_match | The event types included in this query. |
└limit | number | The maximum number of events per page. |
└projectIdnullable | string | Project filter applied, if any. |
└guestProfileIdnullable | string | Guest profile filter applied, if any. |
└alertConfigIdnullable | string | Alert config filter applied, if any. |
data | object | |
└events | array of union | |
└cursornullable | string | Pass this value as the cursor query parameter on your next poll. Null if no results. |
└hasMore | boolean | True if there are more events beyond this page. |