Poll for Updates

GET https://api.podengine.ai/api/v1/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.

API token required Markdown for LLMs

OpenAPI spec

Example request

Install & configure

curl -X GET "https://api.podengine.ai/api/v1/polling/updates?limit=10" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN"

const options = {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  }
};

fetch("https://api.podengine.ai/api/v1/polling/updates?limit=10", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.get("https://api.podengine.ai/api/v1/polling/updates?limit=10", headers=headers)
print(response.json())

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var response = await client.GetAsync("https://api.podengine.ai/api/v1/polling/updates?limit=10");
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

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

func main() {
	req, _ := http.NewRequest("GET", "https://api.podengine.ai/api/v1/polling/updates?limit=10", nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.polling.getUpdates({
  limit: 10,
});

console.log(data);

import os

from podengine import PodEngine

pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])

data = pe.polling.get_updates(
    limit=10,
)

print(data)

200

Example response

{
  "status": "OK",
  "options": {
    "since": "2026-01-15T09:30:00.000Z",
    "cursor": "string",
    "eventTypes": [
      "request_completed"
    ],
    "limit": 0,
    "projectId": "string",
    "guestProfileId": "string",
    "alertConfigId": "string"
  },
  "data": {
    "events": [
      {
        "id": "string",
        "occurredAt": "2026-01-15T09:30:00.000Z",
        "eventType": "request_completed",
        "data": {
          "requestId": "string",
          "requestType": "autoOutreach",
          "podcastId": "string",
          "episodeId": "string",
          "guestProfileId": "string",
          "completedAt": "2026-01-15T09:30:00.000Z",
          "error": "string"
        }
      }
    ],
    "cursor": "string",
    "hasMore": true
  }
}

Request

Query parameters

sincestringdatetime

ISO 8601 timestamp. Return events after this point. Ignored if cursor is provided. Max lookback: 30 days.

cursorstring

Opaque cursor from a previous response. Takes precedence over since.

eventTypesarray of string

Comma-separated list of event types to include: request_completed, guest_appearance, listed_podcast_added, alert_match. Default: all.

projectIdstring

Filter listed_podcast_added events to a specific project.

guestProfileIdstring

Filter guest_appearance events to a specific guest profile.

alertConfigIdstring

Filter alert_match events to a specific alert configuration.

limitnumber1 – 100

Max events per page (1-100, default 50).

Response

200 application/json

statusliteral: OKrequired

optionsobjectrequired7 fields

The resolved options used for this query.

sincestringrequirednullabledatetime

The resolved since timestamp used for this query.

cursorstringrequirednullable

The cursor provided in this request, if any.

eventTypesarray of enumrequired

The event types included in this query.

request_completedguest_appearancelisted_podcast_addedalert_match

limitnumberrequired

The maximum number of events per page.

projectIdstringrequirednullable

Project filter applied, if any.

guestProfileIdstringrequirednullable

Guest profile filter applied, if any.

alertConfigIdstringrequirednullable

Alert config filter applied, if any.

dataobjectrequired3 fields

eventsarray of unionrequired

cursorstringrequirednullable

Pass this value as the cursor query parameter on your next poll. Null if no results.

hasMorebooleanrequired

True if there are more events beyond this page.