Series API

A Series is a named collection of episodes. Every episode must belong to a Series.

Endpoints

List series

GET /series.json

Returns all series for the authenticated user.

Example response:

{
  "success": true,
  "series": [
    {
      "id": "xyz789",
      "title": "My Podcast",
      "episode_count": 42,
      "created_at": "2025-01-01T00:00:00Z"
    }
  ]
}

Get series

GET /series/:id.json

Returns a single series with its episodes.

Create series

POST /series.json

Request:

{
  "series": {
    "title": "My New Series"
  }
}

Response:

{
  "success": true,
  "series": {
    "id": "xyz789",
    "title": "My New Series",
    "episode_count": 0,
    "created_at": "2026-03-20T00:00:00Z"
  }
}

Update series

PATCH /series/:id.json

Request:

{
  "series": {
    "title": "Renamed Series"
  }
}

Delete series

DELETE /series/:id.json

Deletes the series and all episodes within it.

Start a text draft

POST /series/:id/start_text_draft.json

Creates a new text-only episode (no audio) inside the series, opening a blank draft for writing directly in the editor.