Poll for Updates

GET /polling/updates

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.

TOKEN

Authentication

This endpoint requires an API token. You can learn more about how to get an API token from the authentication page.

URL

https://api.podengine.ai/api/v1/polling/updates

Code Example

API Specification

Query Parameters

PropertyTypeDescription
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).

200

Success Response

PropertyTypeDescription
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.