API Changelog

Track changes, new features, and updates to the PageTalk API. Subscribe to the changelog RSS feed to stay updated.

Current Version: v1

The PageTalk API is currently at version 1. All endpoints are prefixed with /v1/. We follow semantic versioning and will maintain backwards compatibility within major versions.

Releases

v1.4.0 — February 15, 2026

Added

  • ElevenLabs TTS integration as an alternative voice engine alongside Gemini
  • Multi-speaker dialogue support via ElevenLabs Text to Dialogue API
  • New tts_provider parameter on POST /v1/episodes and POST /v1/scripts/{id}/convert
  • Per-host voice configuration with elevenlabs_host1_voice_id and elevenlabs_host2_voice_id
  • delivery_preset parameter for controlling narration pacing (measured, dynamic, theatrical)
  • expression_settings object for fine-grained vocal expression control
  • pronunciation_notes parameter for TTS pronunciation guidance
  • elevenlabs_voice_id and elevenlabs_model parameters for ElevenLabs configuration

v1.3.0 — January 29, 2026

Added

  • Document-to-audio conversion API, with status polling for asynchronous document conversions
  • Public URL sharing with listen_url and embed_url on episodes created with public_url: true
  • oEmbed support for automatic embed discovery on supported platforms

v1.2.0 — January 18, 2026

Added

  • Scripts API — generate and preview scripts before converting to audio/video
  • Two-step workflow with POST /v1/scripts and POST /v1/scripts/{id}/convert
  • Script expiration after 2 hours
  • word_count and context_used in script responses

Improved

  • Idempotency key validation with better error messages
  • Request timeout increased to 90 seconds for wait=true

v1.1.0 — January 10, 2026

Added

  • Usage endpoint (GET /v1/usage) for monitoring quota and API requests
  • Rate limit headers on all responses
  • Webhook retry policy with exponential backoff
  • quota.warning and quota.exceeded webhook events

Improved

  • Better error messages with documentation URLs
  • Pagination with cursor-based navigation

Fixed

  • Idempotency key conflict detection for edge cases

v1.0.0 — December 20, 2025

Added

  • Initial public API release
  • Conversions API (POST, GET, DELETE /v1/conversions)
  • API key authentication with lt_live_ and lt_test_ prefixes
  • Synchronous audio generation
  • Asynchronous video generation with polling
  • Per-request webhooks with HMAC-SHA256 signatures
  • Idempotency keys for safe retries
  • Organization-scoped API access

Versioning Policy

The PageTalk API follows semantic versioning:

  • Major versions (v1, v2) — May include breaking changes. Old versions are supported for at least 12 months after a new major version is released.
  • Minor versions (1.1, 1.2) — New features and improvements. Fully backwards compatible.
  • Patch versions (1.1.1) — Bug fixes only. Fully backwards compatible.

Breaking Changes

We consider the following to be breaking changes:

  • Removing an endpoint
  • Removing or renaming a request parameter
  • Removing or renaming a response field
  • Changing the type of a field
  • Adding a new required parameter
  • Changing error codes for existing scenarios

The following are not considered breaking:

  • Adding new optional parameters
  • Adding new fields to responses
  • Adding new endpoints
  • Adding new error codes
  • Adding new webhook event types
  • Changing error messages (codes remain stable)

Deprecation Notices

There are currently no deprecated features in the API.

When features are deprecated, they will be announced here with a minimum 6-month notice period before removal.

PreviousExamples