API changelog

This page lists public API changes that have shipped on main. Dates are the merge dates. Newest entries are first. Work that is still in review is not listed.

2026-11-13 — Delete account

DELETE /api/v1/account deletes the signed-in account after the body {"confirm":"DELETE"}. An active subscription is canceled immediately and is not refunded. Shows, episodes, audio, Script to audio jobs, and API keys are deleted. Stripe keeps the customer and invoices. An allowlisted admin account is refused with 403. The billing page has the same Delete account action. Success is 204.

2026-11-12 — On-demand episodes, topics, and access tokens

POST /api/v1/shows/{id}/episodes starts today's episode with the same Free and Pro rules as the website Generate button, including one episode per delivery day and the deleted-day tombstone. It does not debit prepaid credits. DELETE /api/v1/episodes/{id} deletes one owned episode the same way the website Library does. Success is 204 with no body. A missing bearer token is 401. Another account's episode is 404. The row stays deleted, so that day is not generated again, and an allowlisted admin can still reopen that same row. Show and ShowWrite include topics (news, sports, ai, finance, crypto). The website did not store topic ids before migration 034. Handles remain the X accounts. A signed-in access token works on /api/v1 beside a pp_live_ key and is checked with the auth server. Key rotation and credit pack purchase stay on the API key. /api/mcp tool calls stay on the API key. generate_episode and delete_episode are the MCP tools for those routes.

2026-10-23 — Signup from another IP, English default

Shipped in #80. POST /api/v1/agent-accounts accepts a solved challenge from a different IP than the challenge request. The challenge stays single-use and short-lived. A changed caller IP is not an error. Failed proofs use proof_of_work_expired, proof_of_work_used, or proof_of_work_failed. Signup caps still use signup_rate_limited. Challenge requests and signup attempts use separate per-IP windows. output_language on Script to audio estimate and create defaults to en when the field is omitted or blank. A code that is sent is still validated.

2026-10-23 — Listener audio delete

Shipped in #79. The website can delete the listener's episode audio and Script to audio. /api/v1 has no delete route. After an episode is deleted, GET /api/v1/episodes and GET /api/v1/episodes/{id} can return status deleted with the script cleared, and audio_url is null. GET /api/v1/episodes/{id}/audio then returns 409 because the episode is not ready. A deleted Script to audio job stays on GET /api/v1/script-audio/{id} with status deleted, an empty title, and an empty script preview. GET /api/v1/script-audio omits it once storage deletion has finished. GET /api/v1/script-audio/{id}/download returns 404 with the message that the audio was deleted.

2026-10-22 — Agent accounts

Shipped in #68. An agent can open its own account with POST /api/v1/agent-accounts/challenge and POST /api/v1/agent-accounts. The challenge is proof of work. The new key is shown once. POST /api/v1/agent-accounts/verify-email, POST /api/v1/agent-accounts/claim-link, GET /api/v1/credits, POST /api/v1/credits/checkout, POST /api/v1/credits/transfers, and POST /api/v1/keys/rotate shipped in the same change. Trust tiers gate scopes and limits. GET /api/v1 lists Nora, Leo, Kristine, Ken, and Marko.

2026-10-22 — Public API and credit packs

Shipped in #66. /api/v1 launched with bearer API keys. Signed-in users create those keys at https://postpodai.com/settings/api. The key is shown once and stored as a hash. The first routes were GET /api/v1, GET /api/v1/account/me, show list, create, and update, episode list, episode read, and episode audio, plus Script to audio estimate, create, list, read, and download. Creating a job debits prepaid credits. Packs are $5, $10, $20, $50, $100 USD, bought on the signed-in billing page by card or by USDC. A low balance returns 402. The OpenAPI document and llms.txt shipped with the API.

Read the developer docs, the API rate limits, and the API versioning and deprecation policy.