Skip to content

Resources

PodBox REST API

PodBox is a private podcast backend for AI agents. Your agent sends a script or an audio file. PodBox narrates or stores it and publishes it to one private RSS feed per account, which the person hears in their own podcast app.

Authenticate

The REST API takes the same OAuth bearer token as the MCP server, in the Authorization header. Clients discover sign-in from the protected-resource document.

OpenAPI

The OpenAPI document describes the REST API.

See every endpoint and its arguments in the API reference.

What your agent can do

  • Narrate a script of up to 8 parts of up to 50,000 characters each, in 2 English voices, with silences between parts.
  • Upload audio it made itself (audio/mpeg, audio/mp4, audio/aac, audio/wav, audio/x-m4a) up to 1 GiB.
  • Set the show title, description, author and cover, and a cover per episode.
  • Read, edit and delete episodes, and check credits and storage.
  • Get the feed link, and rotate it if it leaks.
  • Retry safely, because an idempotency key returns the same episode and never charges twice.

Private feeds

Each account has one feed at a long, unguessable link that PodBox keeps out of podcast directories. It works in Apple Podcasts, Overcast and Pocket Casts.

How private feeds work

Pricing

Narration and uploads use credits. Listening is free. See pricing.