{"openapi":"3.1.0","info":{"title":"PostPod API","version":"v1","summary":"Account, shows, episodes, and Script to audio for PostPod.","description":"Versioned HTTP API for PostPod. The current version is v1 in the URL path. Breaking changes ship only in a new version. Additive changes can happen within v1. A retired version, endpoint, or field gets at least 6 months' notice. The versioning and deprecation policy is https://postpodai.com/developers/deprecation. Rate limits are documented at https://postpodai.com/developers/rate-limits. The API changelog is https://postpodai.com/developers/changelog. Authenticate with Authorization: Bearer. A pp_live_ API key created at https://postpodai.com/settings/api works as before. A signed-in access token for the same user also works on show, episode, account, and Script to audio routes. PostPod checks that token with the auth server. POST /api/v1/keys/rotate, POST /api/v1/credits/checkout, POST /api/v1/credits/pay, and POST /api/v1/credits/transfers stay on the API key. POST /api/v1/shows/{id}/episodes starts today's episode with the same Free and Pro rules as the website. Listeners pick X accounts and topics. PostPod picks the posts. A show stores both. Script to audio jobs debit prepaid credits. Daily episodes do not. Credit packs can be paid by card or by USDC stablecoin. The charged price is the same number returned by the estimate endpoint. Voices are Nora, Leo, Kristine, Ken, and Marko. Send a display name or the lowercase id (nora, leo, kristine, ken, marko). Deprecated voice ids are still accepted and are not returned: stock-nora → nora, stock-reed → leo, stock-sienna → kristine, stock-kai → ken, stock-mira → marko. Responses use the current id. The voice field on a response is the display name. Responses that evaluated a rate limiter include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, RateLimit-Policy, and RateLimit. A 429 response also includes Retry-After in seconds. Script to audio does not add an intro or outro. include_intro_outro is deprecated and ignored. Daily podcast episodes still have their intro and outro.\n\nScript to audio quickstart (Python 3, standard library only). Read POSTPOD_API_KEY from the environment. macOS or Linux: export POSTPOD_API_KEY='pp_live_your_key'. Windows PowerShell: $env:POSTPOD_API_KEY = 'pp_live_your_key'.\n\n#!/usr/bin/env python3\n\"\"\"Save a Script to audio MP3. Uses the Python 3 standard library only.\n\nmacOS or Linux:\n    export POSTPOD_API_KEY='pp_live_your_key'\n\nWindows PowerShell:\n    $env:POSTPOD_API_KEY = 'pp_live_your_key'\n\"\"\"\n\nimport json\nimport os\nimport sys\nimport time\nimport urllib.error\nimport urllib.request\nfrom pathlib import Path\n\nAPI = \"https://postpodai.com\"\nOUTPUT = \"script.mp3\"\nPOLL_SECONDS = 3\nPOLL_LIMIT = 120\n\n\ndef main() -> None:\n    key = os.environ.get(\"POSTPOD_API_KEY\", \"\").strip()\n    if not key:\n        print(\"Set POSTPOD_API_KEY to your pp_live_ key.\", file=sys.stderr)\n        raise SystemExit(1)\n\n    body = {\n        \"script\": \"Hello from PostPod. This is a short script.\",\n        \"voice\": \"Nora\",\n        \"input_language\": \"auto\",\n        \"output_language\": \"en\",\n    }\n\n    print(\"Estimating price...\")\n    estimate = call(\"POST\", \"/api/v1/script-audio/estimate\", key, body)\n    print(\n        f\"Estimate: {estimate.get('word_count')} words, \"\n        f\"${estimate.get('price_usd')} (this call does not spend credits)\"\n    )\n\n    print(\"Creating job...\")\n    created = call(\"POST\", \"/api/v1/script-audio\", key, body)\n    job = created[\"job\"]\n    job_id = job[\"id\"]\n    print(f\"Job {job_id} is {job.get('status')}. Balance ${created.get('balance_usd')}\")\n\n    for attempt in range(1, POLL_LIMIT + 1):\n        current = call(\"GET\", f\"/api/v1/script-audio/{job_id}\", key)[\"job\"]\n        status = current.get(\"status\")\n        print(f\"Poll {attempt}: {status}\")\n        if status == \"ready\":\n            job = current\n            break\n        if status == \"failed\":\n            print(current.get(\"error\") or \"Audio failed.\", file=sys.stderr)\n            raise SystemExit(1)\n        time.sleep(POLL_SECONDS)\n    else:\n        print(\"Timed out waiting for audio.\", file=sys.stderr)\n        raise SystemExit(1)\n\n    print(\"Fetching download URL...\")\n    download = call(\"GET\", f\"/api/v1/script-audio/{job_id}/download\", key)\n    url = download[\"download_url\"]\n    print(f\"Saving {OUTPUT}\")\n    urllib.request.urlretrieve(url, OUTPUT)\n    print(f\"Saved {Path(OUTPUT).resolve()}\")\n\n\ndef call(method, path, key, body=None):\n    data = None if body is None else json.dumps(body).encode()\n    headers = {\"Authorization\": f\"Bearer {key}\", \"Accept\": \"application/json\"}\n    if data is not None:\n        headers[\"Content-Type\"] = \"application/json\"\n    request = urllib.request.Request(API + path, data=data, method=method, headers=headers)\n    try:\n        with urllib.request.urlopen(request, timeout=60) as response:\n            return json.loads(response.read().decode())\n    except urllib.error.HTTPError as error:\n        raw = error.read().decode(\"utf-8\", \"replace\")\n        try:\n            problem = json.loads(raw)\n        except json.JSONDecodeError:\n            problem = {\"message\": raw}\n        code = str(problem.get(\"code\") or \"\")\n        message = str(problem.get(\"message\") or problem.get(\"error\") or error.reason)\n        if error.code == 402 or code == \"insufficient_credits\":\n            print(f\"Not enough credits ({code or 'insufficient_credits'}): {message}\", file=sys.stderr)\n            topup = problem.get(\"top_up_url\")\n            if topup:\n                print(f\"Buy credits: {topup}\", file=sys.stderr)\n        else:\n            print(f\"HTTP {error.code} {code}: {message}\", file=sys.stderr)\n            resolution = problem.get(\"resolution\")\n            if resolution:\n                print(resolution, file=sys.stderr)\n        raise SystemExit(1)\n\n\nif __name__ == \"__main__\":\n    main()\n\n# Accepted script files for POST /api/v1/script-audio/extract are .txt, .md, .docx, and .pdf.\n# Send multipart form field \"file\" and voice Nora, Leo, Kristine, Ken, or Marko.\n# The response is the extracted text, word count, and price. It does not create a job or spend credits.\n\n\ncurl on macOS or Linux:\n\n# macOS or Linux\nset -eu\nexport POSTPOD_API_KEY='pp_live_your_key'\nBASE=\"https://postpodai.com\"\nBODY='{\"script\":\"Hello from PostPod. This is a short script.\",\"voice\":\"Nora\",\"input_language\":\"auto\",\"output_language\":\"en\"}'\n\necho \"Estimating price...\"\ncurl -sS -f -H \"Authorization: Bearer $POSTPOD_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"$BODY\" \\\n  \"$BASE/api/v1/script-audio/estimate\"\necho\n\necho \"Creating job...\"\ncurl -sS -H \"Authorization: Bearer $POSTPOD_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d \"$BODY\" \\\n  \"$BASE/api/v1/script-audio\" -o create.json\npython3 -c 'import json,sys; body=json.load(open(\"create.json\"));\ncode=body.get(\"code\");\nsys.exit(print(\"Not enough credits:\", body.get(\"message\"), body.get(\"top_up_url\") or \"\") or 1) if body.get(\"status\")==402 or code==\"insufficient_credits\" else None;\nprint(\"Job\", body[\"job\"][\"id\"], body[\"job\"].get(\"status\"))'\nJOB_ID=$(python3 -c 'import json; print(json.load(open(\"create.json\"))[\"job\"][\"id\"])')\n\necho \"Polling $JOB_ID...\"\nwhile true; do\n  curl -sS -f -H \"Authorization: Bearer $POSTPOD_API_KEY\" \\\n    \"$BASE/api/v1/script-audio/$JOB_ID\" -o job.json\n  STATUS=$(python3 -c 'import json; print(json.load(open(\"job.json\"))[\"job\"][\"status\"])')\n  echo \"Status: $STATUS\"\n  if [ \"$STATUS\" = \"ready\" ]; then\n    break\n  fi\n  if [ \"$STATUS\" = \"failed\" ]; then\n    python3 -c 'import json,sys; print(json.load(open(\"job.json\"))[\"job\"].get(\"error\") or \"Audio failed.\", file=sys.stderr)'\n    exit 1\n  fi\n  sleep 3\ndone\n\necho \"Fetching download URL...\"\ncurl -sS -f -H \"Authorization: Bearer $POSTPOD_API_KEY\" \\\n  \"$BASE/api/v1/script-audio/$JOB_ID/download\" -o download.json\nURL=$(python3 -c 'import json; print(json.load(open(\"download.json\"))[\"download_url\"])')\ncurl -fsSL \"$URL\" -o script.mp3\necho \"Saved script.mp3\"\n\n# Preview a file without creating a job. Accepted types: .txt, .md, .docx, .pdf\n# curl -sS -f -H \"Authorization: Bearer $POSTPOD_API_KEY\" \\\n#   -F \"file=@script.pdf\" -F \"voice=Nora\" \\\n#   \"$BASE/api/v1/script-audio/extract\"\n\n\ncurl on Windows PowerShell:\n\n# Windows PowerShell. curl is curl.exe, not Invoke-WebRequest.\n$env:POSTPOD_API_KEY = 'pp_live_your_key'\n$base = \"https://postpodai.com\"\n$body = @'\n{\"script\":\"Hello from PostPod. This is a short script.\",\"voice\":\"Nora\",\"input_language\":\"auto\",\"output_language\":\"en\"}\n'@\n\nWrite-Host \"Estimating price...\"\ncurl.exe -sS -f -H \"Authorization: Bearer $env:POSTPOD_API_KEY\" `\n  -H \"Content-Type: application/json\" `\n  -d $body `\n  \"$base/api/v1/script-audio/estimate\"\nWrite-Host \"\"\n\nWrite-Host \"Creating job...\"\ncurl.exe -sS -H \"Authorization: Bearer $env:POSTPOD_API_KEY\" `\n  -H \"Content-Type: application/json\" `\n  -d $body `\n  \"$base/api/v1/script-audio\" -o create.json\n$created = Get-Content create.json -Raw | ConvertFrom-Json\nif ($created.status -eq 402 -or $created.code -eq \"insufficient_credits\") {\n  Write-Error \"Not enough credits: $($created.message) $($created.top_up_url)\"\n  exit 1\n}\n$jobId = $created.job.id\nWrite-Host \"Job $jobId is $($created.job.status)\"\n\nWrite-Host \"Polling $jobId...\"\nwhile ($true) {\n  curl.exe -sS -f -H \"Authorization: Bearer $env:POSTPOD_API_KEY\" `\n    \"$base/api/v1/script-audio/$jobId\" -o job.json\n  $job = (Get-Content job.json -Raw | ConvertFrom-Json).job\n  Write-Host \"Status: $($job.status)\"\n  if ($job.status -eq \"ready\") { break }\n  if ($job.status -eq \"failed\") {\n    if ($job.error) { Write-Error $job.error } else { Write-Error \"Audio failed.\" }\n    exit 1\n  }\n  Start-Sleep -Seconds 3\n}\n\nWrite-Host \"Fetching download URL...\"\ncurl.exe -sS -f -H \"Authorization: Bearer $env:POSTPOD_API_KEY\" `\n  \"$base/api/v1/script-audio/$jobId/download\" -o download.json\n$url = (Get-Content download.json -Raw | ConvertFrom-Json).download_url\ncurl.exe -fsSL $url -o script.mp3\nWrite-Host \"Saved script.mp3\"\n\n# Preview a file without creating a job. Accepted types: .txt, .md, .docx, .pdf\n# curl.exe -sS -f -H \"Authorization: Bearer $env:POSTPOD_API_KEY\" `\n#   -F \"file=@script.pdf\" -F \"voice=Nora\" `\n#   \"$base/api/v1/script-audio/extract\"\n An agent can create its own account with a proof-of-work challenge, then pay with prepaid credits. A new agent can estimate scripts and buy credit packs. Funding, a verified operator email, or a human claim raises the limits.","x-api-lifecycle":{"currentVersion":"v1","versionLocation":"url-path","status":"active","deprecationPolicy":"https://postpodai.com/developers/deprecation","rateLimits":"https://postpodai.com/developers/rate-limits","changelog":"https://postpodai.com/developers/changelog","minimumNoticeMonths":6,"deprecatedVoiceIds":[{"alias":"stock-nora","id":"nora","deprecated":true},{"alias":"stock-reed","id":"leo","deprecated":true},{"alias":"stock-sienna","id":"kristine","deprecated":true},{"alias":"stock-kai","id":"ken","deprecated":true},{"alias":"stock-mira","id":"marko","deprecated":true}],"deprecationHeader":"Deprecation","sunsetHeader":"Sunset","deprecationLinkRelation":"deprecation"}},"externalDocs":{"description":"API versioning and deprecation policy","url":"https://postpodai.com/developers/deprecation"},"servers":[{"url":"https://postpodai.com","description":"PostPod"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Discovery","description":"Find the API, docs, and OpenAPI document."},{"name":"Account","description":"The signed-in account and credit balance."},{"name":"Shows","description":"The daily podcast show. One show per account."},{"name":"Episodes","description":"Generated daily episodes and their audio."},{"name":"Script to audio","description":"Turn a script into spoken audio using prepaid credits."},{"name":"Agent accounts","description":"Self-serve agent signup, claim links, and operator email."},{"name":"Credits","description":"Prepaid balance, Stripe pack checkout, and transfers to a claimed agent."},{"name":"Keys","description":"Rotate the API key that authenticated the request."}],"paths":{"/api/v1":{"get":{"operationId":"getApiIndex","tags":["Discovery"],"summary":"API index","description":"Returns links to the developer docs and the OpenAPI document. No API key is required.","security":[],"responses":{"200":{"description":"Service index.","headers":{"Link":{"description":"Described-by links for the deprecation policy and the rate-limit reference. v1 is current, so this response does not send Deprecation or Sunset.","required":true,"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiIndex"},"example":{"name":"PostPod API","version":"v1","docs_url":"https://postpodai.com/developers","openapi_url":"https://postpodai.com/openapi.json","llms_url":"https://postpodai.com/llms.txt","llms_full_url":"https://postpodai.com/llms-full.txt","deprecation_policy_url":"https://postpodai.com/developers/deprecation","rate_limits_url":"https://postpodai.com/developers/rate-limits","changelog_url":"https://postpodai.com/developers/changelog","signup_url":"https://postpodai.com/signup","api_keys_url":"https://postpodai.com/settings/api","authentication":"Authorization: Bearer pp_live_… or a signed-in access token","voices":[{"name":"Nora","description":"Clear single-narrator voice (free tier)","gender":"female"},{"name":"Leo","description":"Warm mid-range narrator (Pro)","gender":"male"},{"name":"Kristine","description":"Bright conversational narrator (Pro)","gender":"female"},{"name":"Ken","description":"Low, even newsreader (Pro)","gender":"male"},{"name":"Marko","description":"Crisp international narrator (Pro)","gender":"male"}]}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/account":{"delete":{"operationId":"deleteAccount","tags":["Account"],"summary":"Delete the account","description":"Deletes the signed-in account. Send {\"confirm\":\"DELETE\"}. Any other body is 400. An active Stripe subscription is canceled immediately and is not refunded. The show, episodes, episode audio, Script to audio jobs and their audio, API keys, push tokens, and the account are deleted. Stripe keeps the customer and the invoices. Cached posts shared with other shows are kept. An allowlisted admin account is 403. A missing or rejected bearer token is 401. Repeating the request after the account is gone is safe. A frozen account can still delete itself.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountDelete"},"example":{"confirm":"DELETE"}}}},"responses":{"204":{"description":"The account was deleted. The response has no body.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"400":{"description":"The body must be {\"confirm\":\"DELETE\"}.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key or access token is missing or was not recognized.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"This account is on the admin allowlist and cannot be deleted here.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"503":{"description":"The subscription could not be canceled because billing is not configured.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}}}}},"/api/v1/account/me":{"get":{"operationId":"getAccount","tags":["Account"],"summary":"Current account","description":"Returns the account id, email, plan, credit balance, account kind, trust tier, limits, and UTC-day usage. Human accounts have a null tier. Agent limits follow the trust tier unless an override is set.","responses":{"200":{"description":"The account that owns the API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"},"example":{"id":"11111111-1111-4111-8111-111111111111","email":"listener@example.com","plan":"free","credits":{"balance_usd":10,"currency":"USD"},"kind":"agent","tier":"funded","status":"active","limits":{"requests_per_minute":10,"jobs_per_hour":5,"script_word_limit":5000,"daily_topup_cap_usd":100,"daily_spend_limit_usd":null},"usage_today":{"spend_usd":1,"topup_usd":20,"transfer_in_usd":0,"transfer_out_usd":0,"jobs":1}}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/push-tokens":{"post":{"operationId":"upsertPushToken","tags":["Account"],"summary":"Register an iOS push token","description":"Saves an Expo push token for the signed-in account. A bearer API key or a signed-in access token is required. token must be ExponentPushToken[...] or ExpoPushToken[...]. platform must be ios. device_name is optional. Sending the same token again updates that row, turns it back on, and moves it to this account when another account had registered it. The response omits provider error text.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushTokenUpsert"},"example":{"token":"ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]","platform":"ios","device_name":"iPhone"}}}},"responses":{"200":{"description":"The token is saved for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushTokenResult"},"example":{"push_token":{"id":"8c1d2e3f-4a5b-4c6d-8e7f-901234567890","token":"ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]","platform":"ios","device_name":"iPhone","enabled":true,"created_at":"2026-11-18T12:00:00.000Z","last_seen_at":"2026-11-18T12:00:00.000Z"}}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"400":{"description":"The body was not JSON.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key or access token is missing or was not recognized.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"422":{"description":"The token, platform, or device name is not valid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"503":{"description":"Push tokens are not available until migration 036 is applied.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}}}},"delete":{"operationId":"deletePushToken","tags":["Account"],"summary":"Remove an iOS push token","description":"Deletes one Expo push token that belongs to the signed-in account. A bearer API key or a signed-in access token is required. The body is {token}. A token this account does not own is 404. Success is 204 with no body. DELETE /api/v1/account also removes every token for the account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushTokenDelete"},"example":{"token":"ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]"}}}},"responses":{"204":{"description":"The token was removed. The response has no body.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"400":{"description":"The body was not JSON.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key or access token is missing or was not recognized.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"This account has no row for that token.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"422":{"description":"The token is not an ExponentPushToken or ExpoPushToken.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"503":{"description":"Push tokens are not available until migration 036 is applied.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}}}}},"/api/v1/shows":{"get":{"operationId":"listShows","tags":["Shows"],"summary":"List shows","description":"Lists the account's show. Accounts have one show, so the array has zero or one item.","responses":{"200":{"description":"Shows for this account.","content":{"application/json":{"schema":{"type":"object","properties":{"shows":{"type":"array","items":{"$ref":"#/components/schemas/Show"}},"plan":{"type":"string","enum":["free","pro"]}},"required":["shows","plan"]},"example":{"shows":[{"id":"4f5fb478-1c0a-4e3a-9a11-0b1e8c0a1111","name":"Morning brief","handles":["openai"],"topics":["ai"],"language":"en","voice":"Nora","timezone":"America/New_York","delivery_hhmm":"07:00","plan":"free","created_at":"2026-10-20T12:00:00.000Z","updated_at":"2026-10-20T12:00:00.000Z"}],"plan":"free"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}},"post":{"operationId":"createShow","tags":["Shows"],"summary":"Create a show","description":"Creates the account's show using the same limits as the website: handle count, language, voice, and delivery time depend on the plan. language defaults to English (en) when omitted or blank. An explicit language is still validated: Free is English only, and Pro can use any supported language. Fails when a show already exists.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowWrite"},"example":{"name":"Morning brief","handles":["openai"],"language":"en","voice":"Nora","timezone":"America/New_York","delivery_hhmm":"07:00"}}}},"responses":{"201":{"description":"The show was created.","content":{"application/json":{"schema":{"type":"object","properties":{"show":{"$ref":"#/components/schemas/Show"}},"required":["show"]},"example":{"show":{"id":"4f5fb478-1c0a-4e3a-9a11-0b1e8c0a1111","name":"Morning brief","handles":["openai"],"topics":["ai"],"language":"en","voice":"Nora","timezone":"America/New_York","delivery_hhmm":"07:00","plan":"free","created_at":"2026-10-20T12:00:00.000Z","updated_at":"2026-10-20T12:00:00.000Z"}}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"409":{"description":"The account already has a show. Update it instead.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"422":{"description":"The show fields are outside the plan limits.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/shows/{id}":{"get":{"operationId":"getShow","tags":["Shows"],"summary":"Get a show","description":"Returns one show owned by the API key's account.","parameters":[{"name":"id","in":"path","required":true,"description":"Show id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The show.","content":{"application/json":{"schema":{"type":"object","properties":{"show":{"$ref":"#/components/schemas/Show"}},"required":["show"]},"example":{"show":{"id":"4f5fb478-1c0a-4e3a-9a11-0b1e8c0a1111","name":"Morning brief","handles":["openai"],"topics":["ai"],"language":"en","voice":"Nora","timezone":"America/New_York","delivery_hhmm":"07:00","plan":"free","created_at":"2026-10-20T12:00:00.000Z","updated_at":"2026-10-20T12:00:00.000Z"}}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"No show with that id belongs to this account.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}},"patch":{"operationId":"updateShow","tags":["Shows"],"summary":"Update a show","description":"Replaces the show settings. The plan limits match the website. language defaults to English (en) when omitted or blank. An explicit language is still validated: Free is English only, and Pro can use any supported language. This does not change the subscription.","parameters":[{"name":"id","in":"path","required":true,"description":"Show id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShowWrite"},"example":{"name":"Morning brief","handles":["openai","nasa"],"language":"en","voice":"Nora","timezone":"America/New_York","delivery_hhmm":"07:30"}}}},"responses":{"200":{"description":"The updated show.","content":{"application/json":{"schema":{"type":"object","properties":{"show":{"$ref":"#/components/schemas/Show"}},"required":["show"]},"example":{"show":{"id":"4f5fb478-1c0a-4e3a-9a11-0b1e8c0a1111","name":"Morning brief","handles":["openai"],"topics":["ai"],"language":"en","voice":"Nora","timezone":"America/New_York","delivery_hhmm":"07:00","plan":"free","created_at":"2026-10-20T12:00:00.000Z","updated_at":"2026-10-20T12:00:00.000Z"}}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"No show with that id belongs to this account.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"422":{"description":"The show fields are outside the plan limits.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/shows/{id}/episodes":{"post":{"operationId":"startEpisode","tags":["Episodes"],"summary":"Start today's episode","description":"Starts the same episode pipeline as the website Generate button. Free accounts get one episode per delivery day. A ready episode for that day is returned and is not generated again. A deleted episode stays deleted. The run records the same usage as the website and does not debit prepaid credits. Poll GET /api/v1/episodes/{id} with the returned id. discard_script drops the saved draft, the same as Generate again on the website.","parameters":[{"name":"id","in":"path","required":true,"description":"Show id.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodeStart"},"example":{"discard_script":false}}}},"responses":{"200":{"description":"Today's episode is already ready, or generation finished in this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodeStartResult"},"example":{"episode":{"id":"75ec3a24-2d1b-4f4b-8b22-1c2f9d1b2222","show_id":"4f5fb478-1c0a-4e3a-9a11-0b1e8c0a1111","delivery_date":"2026-10-20","status":"ready","duration_sec":300,"error":null,"audio_url":"https://postpodai.com/api/v1/episodes/75ec3a24-2d1b-4f4b-8b22-1c2f9d1b2222/audio","created_at":"2026-10-20T12:00:00.000Z"},"queued":false}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"202":{"description":"Generation was queued. Poll GET /api/v1/episodes/{id}.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpisodeStartResult"},"example":{"episode":{"id":"75ec3a24-2d1b-4f4b-8b22-1c2f9d1b2222","show_id":"4f5fb478-1c0a-4e3a-9a11-0b1e8c0a1111","delivery_date":"2026-10-20","status":"generating","duration_sec":null,"error":null,"audio_url":null,"created_at":"2026-10-20T12:00:00.000Z"},"queued":true}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key or access token is missing or was not recognized.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"This account cannot start an episode.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"404":{"description":"No show with that id belongs to this account.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"409":{"description":"Daily production is paused, or today's episode was deleted and is not generated again.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"422":{"description":"The show needs at least one X account, or discard_script was not a boolean.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The key or session has reached its rate limit.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"503":{"description":"Episode generation is not configured on this deployment.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}}}}},"/api/v1/episodes":{"get":{"operationId":"listEpisodes","tags":["Episodes"],"summary":"List episodes","description":"Lists recent daily episodes for this account, newest delivery date first.","responses":{"200":{"description":"Episodes for this account.","content":{"application/json":{"schema":{"type":"object","properties":{"episodes":{"type":"array","items":{"$ref":"#/components/schemas/Episode"}}},"required":["episodes"]},"example":{"episodes":[{"id":"75ec3a24-2d1b-4f4b-8b22-1c2f9d1b2222","show_id":"4f5fb478-1c0a-4e3a-9a11-0b1e8c0a1111","delivery_date":"2026-10-20","status":"ready","duration_sec":300,"error":null,"audio_url":"https://postpodai.com/api/v1/episodes/75ec3a24-2d1b-4f4b-8b22-1c2f9d1b2222/audio","created_at":"2026-10-20T12:00:00.000Z"}]}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/episodes/{id}":{"get":{"operationId":"getEpisode","tags":["Episodes"],"summary":"Get an episode","description":"Returns one episode, including the script when one was saved, and an audio URL when the MP3 is ready.","parameters":[{"name":"id","in":"path","required":true,"description":"Episode id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The episode.","content":{"application/json":{"schema":{"type":"object","properties":{"episode":{"$ref":"#/components/schemas/EpisodeDetail"}},"required":["episode"]},"example":{"episode":{"id":"75ec3a24-2d1b-4f4b-8b22-1c2f9d1b2222","show_id":"4f5fb478-1c0a-4e3a-9a11-0b1e8c0a1111","delivery_date":"2026-10-20","status":"ready","duration_sec":300,"error":null,"audio_url":"https://postpodai.com/api/v1/episodes/75ec3a24-2d1b-4f4b-8b22-1c2f9d1b2222/audio","created_at":"2026-10-20T12:00:00.000Z","script":"Good morning. Here is your brief."}}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"No episode with that id belongs to this account.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}},"delete":{"operationId":"deleteEpisode","tags":["Episodes"],"summary":"Delete an episode","description":"Deletes one episode the same way the website Library does. The row stays as a tombstone with status deleted, the script is cleared, and the audio file is removed. A later Generate for that day does not create a new episode. An allowlisted admin can still reopen that same row from Generate now. An episode that is not this account's, or that does not exist, is 404. Deleting an episode that is already deleted returns 204 with no body. An episode that is still generating returns 409. Audio already removed by retention returns 410 with code expired. This does not debit prepaid credits. A missing or rejected bearer token is 401.","parameters":[{"name":"id","in":"path","required":true,"description":"Episode id.","schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"The episode was deleted, or it was already deleted. The response has no body.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key or access token is missing or was not recognized.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"This account cannot delete an episode.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"404":{"description":"No episode with that id belongs to this account.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"409":{"description":"The episode is still being generated.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"410":{"description":"The audio was deleted after 30 days. code is expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"502":{"description":"The script was cleared, but the audio file could not be removed. Retry the delete.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}}}}},"/api/v1/episodes/{id}/audio":{"get":{"operationId":"getEpisodeAudio","tags":["Episodes"],"summary":"Episode audio URL","description":"Returns a temporary URL for an episode MP3 that is still inside the 30-day retention window. The URL expires in six hours. After that window the response is 410 and code is expired.","parameters":[{"name":"id","in":"path","required":true,"description":"Episode id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"A temporary download URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioDownload"},"example":{"id":"75ec3a24-2d1b-4f4b-8b22-1c2f9d1b2222","download_url":"https://example.r2.cloudflarestorage.com/episode.mp3","expires_in_sec":21600,"content_type":"audio/mpeg"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"No episode with that id belongs to this account, or the listener deleted it inside the retention window.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"409":{"description":"The episode audio is not ready yet.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"410":{"description":"The audio was deleted after 30 days. code is expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/script-audio/extract":{"post":{"operationId":"extractScriptAudio","tags":["Script to audio"],"summary":"Extract text from a script file","description":"Reads a .txt, .md, .docx, or .pdf file up to 2 MB and returns the text, word count, length, and price. PDF bytes must start with the PDF header. Password-protected PDFs and scans are rejected, and there is no OCR. The text is the same text the website puts in the editor. This does not create a job and does not spend credits. Send the returned script to POST /api/v1/script-audio when you want audio. POST /api/v1/script-audio/estimate accepts the same multipart file when you only need the price. Requires SCRIPT_AUDIO_ENABLED. An API key whose account email is on ADMIN_EMAILS keeps price_usd and also returns amount_due_usd 0 and complimentary true. Voices are Nora, Leo, Kristine, Ken, and Marko.","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/ScriptAudioFile"},"example":{"file":"script.pdf","voice":"Nora","input_language":"auto","output_language":"en"}}}},"responses":{"200":{"description":"The extracted text and a price quote. No job was created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScriptAudioExtract"},"example":{"script":"Hello from PostPod. This is a short script.","filename":"script.pdf","word_count":8,"char_count":42,"duration_sec":3,"price_usd":1,"word_limit":25000,"voice":"Nora","input_language":"auto","output_language":"en","error_code":null,"error_message":null}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"Script to audio is turned off.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"415":{"description":"The body was not a multipart form with a file.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"422":{"description":"The file could not be read, or the voice or language was rejected.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/script-audio/estimate":{"post":{"operationId":"estimateScriptAudio","tags":["Script to audio"],"summary":"Estimate a script price","description":"Returns the word count, length, and price for a script. The price matches the website and is the amount a later create call debits. Language does not change the price. output_language defaults to English (en) when omitted. include_intro_outro is deprecated and ignored: the audio never includes an intro or outro. This does not create a job and does not spend credits. Send JSON, or a multipart form whose file field is a .txt, .md, .docx, or .pdf. A PDF is read for text. Password-protected PDFs and scans are rejected. POST /api/v1/script-audio/extract returns that text. Requires SCRIPT_AUDIO_ENABLED. An API key whose account email is on ADMIN_EMAILS keeps price_usd and also returns amount_due_usd 0 and complimentary true. That key uses a higher word_limit.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScriptAudioRequest"},"example":{"script":"Hello from PostPod. This is a short script.","voice":"Nora","input_language":"auto","output_language":"en"}}}},"responses":{"200":{"description":"A price quote.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScriptAudioEstimate"},"example":{"word_count":8,"char_count":42,"duration_sec":3,"price_usd":1,"word_limit":25000,"voice":"Nora","input_language":"auto","output_language":"en","error_code":null,"error_message":null}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"Script to audio is turned off.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"422":{"description":"The script, voice, or language cannot be priced.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/script-audio":{"get":{"operationId":"listScriptAudio","tags":["Script to audio"],"summary":"List script jobs","description":"Lists Script to audio jobs for this account. Queued and generating jobs are included, with in_progress true, even when progress is still null, so a caller can see the job that blocks a new create. Unpaid website checkout attempts are omitted.","responses":{"200":{"description":"Script jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"$ref":"#/components/schemas/ScriptAudioJob"}}},"required":["jobs"]},"example":{"jobs":[{"id":"c27b19e8-3e2c-405c-9c33-2d3a0e2c3333","status":"queued","phase":"paid","progress":null,"error":null,"duration_sec":24,"title":"Hello from PostPod.","voice":"Nora","input_language":"auto","output_language":"en","detected_language":null,"word_count":4,"char_count":20,"price_usd":1,"charged_usd":1,"in_progress":true,"source":"paste","filename":null,"script_preview":"Hello from PostPod.","created_at":"2026-10-20T12:00:00.000Z","expires_at":"2026-11-19T12:00:00.000Z","downloadable":false,"download_url":null,"estimated_seconds_remaining":180,"estimated_seconds_approximate":true}]}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"Script to audio is turned off.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}},"post":{"operationId":"createScriptAudio","tags":["Script to audio"],"summary":"Create a script job","description":"Debits the estimated price from prepaid credits and starts audio generation. The voice is a display name: Nora, Leo, Kristine, Ken, or Marko. output_language defaults to English (en) when omitted and is validated when present. include_intro_outro is deprecated and ignored, and the MP3 never includes an intro or outro. A low balance returns 402 and a top-up link. A failed job returns the debit to the balance. Requires SCRIPT_AUDIO_ENABLED. An API key whose account email is on ADMIN_EMAILS does not debit credits, does not return 402 for a zero balance, and is not subject to the hourly job cap, the daily spend cap, or the per-key word cap. The response then includes amount_due_usd 0 and complimentary true. price_usd stays the real quote. The per-minute request cap still applies. Send Idempotency-Key to retry this create safely. The same key, or the same script, voice, and languages within two minutes, returns the original job and does not debit again. A second script is refused with 409 while one is still queued or generating, and an identical script is refused with 409 for 15 minutes, unless the request also sends X-Script-Audio-Confirm: another. A 409 script_audio_active includes job_id and job_url for the blocking job. Its message says you have already paid only when that job was charged. Otherwise the message is You already have audio being made. A queued job with no progress for more than 30 minutes, or a render whose progress and heartbeat have not changed for 2 hours, is failed before that 409 and does not block.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional retry key, 8 to 80 letters, numbers, underscores, or hyphens. The same key returns the original job and does not debit again.","schema":{"type":"string","minLength":8,"maxLength":80},"example":"script-2026-11-01-a"},{"name":"X-Script-Audio-Confirm","in":"header","required":false,"description":"Send the value another to pay for a second job while one is still running, or to submit the same script again inside 15 minutes.","schema":{"type":"string","enum":["another"]},"example":"another"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScriptAudioRequest"},"example":{"script":"Hello from PostPod. This is a short script.","voice":"Leo","input_language":"auto","output_language":"en"}}}},"responses":{"201":{"description":"The job was paid with credits and queued.","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"$ref":"#/components/schemas/ScriptAudioJob"},"balance_usd":{"type":"number"}},"required":["job","balance_usd"]},"example":{"job":{"id":"c27b19e8-3e2c-405c-9c33-2d3a0e2c3333","status":"queued","phase":"paid","progress":null,"error":null,"duration_sec":24,"title":"Hello from PostPod.","voice":"Nora","input_language":"auto","output_language":"en","detected_language":null,"word_count":4,"char_count":20,"price_usd":1,"charged_usd":1,"in_progress":true,"source":"paste","filename":null,"script_preview":"Hello from PostPod.","created_at":"2026-10-20T12:00:00.000Z","expires_at":"2026-11-19T12:00:00.000Z","downloadable":false,"download_url":null,"estimated_seconds_remaining":180,"estimated_seconds_approximate":true},"balance_usd":9}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"402":{"description":"The credit balance is lower than the price. Buy a pack and retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"Script to audio is turned off.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"409":{"description":"A script job is already running, or this script was submitted recently. script_audio_active includes job_id and job_url. The message says you have already paid only when that job was charged. Send X-Script-Audio-Confirm: another to start another paid job.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"422":{"description":"The script, voice, or language was rejected.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/script-audio/{id}":{"get":{"operationId":"getScriptAudio","tags":["Script to audio"],"summary":"Get a script job","description":"Returns the status of one Script to audio job owned by this account. progress is 0 to 1. estimated_seconds_remaining is an optional whole number of seconds derived from chunk progress and elapsed time, or from script length and historical processing speed before that progress exists. It is null when the job is not running and during the final join and encode. estimated_seconds_approximate is true for that early estimate. Clients that do not use these fields can ignore them.","parameters":[{"name":"id","in":"path","required":true,"description":"Script job id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The script job.","content":{"application/json":{"schema":{"type":"object","properties":{"job":{"$ref":"#/components/schemas/ScriptAudioJob"}},"required":["job"]},"example":{"job":{"id":"c27b19e8-3e2c-405c-9c33-2d3a0e2c3333","status":"queued","phase":"paid","progress":null,"error":null,"duration_sec":24,"title":"Hello from PostPod.","voice":"Nora","input_language":"auto","output_language":"en","detected_language":null,"word_count":4,"char_count":20,"price_usd":1,"charged_usd":1,"in_progress":true,"source":"paste","filename":null,"script_preview":"Hello from PostPod.","created_at":"2026-10-20T12:00:00.000Z","expires_at":"2026-11-19T12:00:00.000Z","downloadable":false,"download_url":null,"estimated_seconds_remaining":180,"estimated_seconds_approximate":true}}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"No script job with that id belongs to this account, or the feature is off.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/script-audio/{id}/download":{"get":{"operationId":"downloadScriptAudio","tags":["Script to audio"],"summary":"Script audio URL","description":"Returns a temporary URL for a ready MP3 that is still inside the 30-day retention window. The URL expires in ten minutes. After that window the response is 410 and code is expired.","parameters":[{"name":"id","in":"path","required":true,"description":"Script job id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"A temporary download URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudioDownload"},"example":{"id":"c27b19e8-3e2c-405c-9c33-2d3a0e2c3333","download_url":"https://example.r2.cloudflarestorage.com/script.mp3","expires_in_sec":600,"content_type":"audio/mpeg"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, or revoked.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"No script job with that id belongs to this account.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"409":{"description":"The audio is not ready, or the job failed.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"410":{"description":"The audio was deleted after 30 days. code is expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/agent-accounts/challenge":{"post":{"operationId":"createAgentSignupChallenge","tags":["Agent accounts"],"summary":"Request a signup challenge","description":"Returns a short-lived single-use SHA-256 prefix challenge. Find a nonce such that sha256(challenge_id + ':' + challenge + ':' + nonce) starts with `difficulty` zero hex digits. The challenge is not bound to the caller IP. No API key is required. Challenge requests are rate limited per IP.","security":[],"responses":{"200":{"description":"A challenge the agent must solve once.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentChallenge"},"example":{"challenge_id":"33333333-3333-4333-8333-333333333333","challenge":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","difficulty":4,"algorithm":"sha256-prefix","expires_at":"2026-10-20T12:10:00.000Z"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"This IP has requested too many challenges.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"503":{"description":"Agent signup storage is not available.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}}}}},"/api/v1/agent-accounts":{"post":{"operationId":"createAgentAccount","tags":["Agent accounts"],"summary":"Create an agent account","description":"Checks the proof of work, creates an agent profile, and returns an API key once. The balance starts at 0 and the tier is new. The claim URL is signed and expires. No API key is required. The challenge stays single-use, short-lived, and bound to the proof of work. It is not bound to the IP that requested it. Signup attempts and created accounts are rate limited per IP.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSignupRequest"},"example":{"challenge_id":"33333333-3333-4333-8333-333333333333","nonce":"1a2b3c","name":"Research agent","operator_email":"ops@example.com"}}}},"responses":{"201":{"description":"The agent account and its one-time API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSignup"},"example":{"account_id":"22222222-2222-4222-8222-222222222222","api_key":"pp_live_example_key_shown_once","balance_usd":0,"tier":"new","status":"active","limits":{"requests_per_minute":10,"jobs_per_hour":0,"script_word_limit":0,"daily_topup_cap_usd":100,"daily_spend_limit_usd":0},"claim_url":"https://postpodai.com/claim/example.token","claim_expires_at":"2026-10-27T12:00:00.000Z"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"422":{"description":"The name, nonce, or challenge was rejected. Codes are validation_error, proof_of_work_expired, proof_of_work_used, and proof_of_work_failed. A different caller IP is not a rejection.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"429":{"description":"This network sent too many signup attempts or created too many agent accounts.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"503":{"description":"Agent signup is not configured.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}}}}},"/api/v1/agent-accounts/claim-link":{"post":{"operationId":"createAgentClaimLink","tags":["Agent accounts"],"summary":"Create a claim link","description":"Returns a signed claim URL for this agent account. A signed-in human opens it and the tier becomes claimed. The link expires. Authenticate with the agent key.","responses":{"200":{"description":"A signed claim URL.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentClaimLink"},"example":{"url":"https://postpodai.com/claim/example.token","expires_at":"2026-10-27T12:00:00.000Z"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, revoked, or expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"403":{"description":"This key is not an active agent account.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/agent-accounts/verify-email":{"post":{"operationId":"verifyAgentEmail","tags":["Agent accounts"],"summary":"Verify the operator email","description":"Send this without a code to email a 6-digit code to operator_email. Send the code to confirm. A confirmed address moves the tier to verified unless the account is already claimed. Delivery uses Resend when RESEND_API_KEY is set.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEmailVerifyRequest"},"example":{"code":"123456"}}}},"responses":{"200":{"description":"The operator email is confirmed, or a code was sent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentEmailVerifyResult"},"example":{"verified":true,"tier":"verified"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, revoked, or expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"422":{"description":"The code does not match, or the operator email is missing.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"503":{"description":"Email delivery is not configured.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}}}}},"/api/v1/keys/rotate":{"post":{"operationId":"rotateApiKey","tags":["Keys"],"summary":"Rotate the current API key","description":"Issues a new key and revokes the key that authenticated this request. Scopes, the daily spend cap, and expiry are copied. The new secret is returned once.","responses":{"200":{"description":"The replacement key. The previous key is revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotatedApiKey"},"example":{"id":"44444444-4444-4444-8444-444444444444","api_key":"pp_live_rotated_key_shown_once","prefix":"pp_live_ro","name":"Research agent","scopes":["account:read","credits:read"],"daily_spend_limit_usd":null,"expires_at":null}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, revoked, or expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/credits":{"get":{"operationId":"getCredits","tags":["Credits"],"summary":"Credit balance and usage","description":"Returns the prepaid balance, UTC-day usage from the ledger, and recent ledger entries. Transfer rows use kind transfer.","responses":{"200":{"description":"Balance, today's usage, and recent ledger entries.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditAccount"},"example":{"balance_usd":10,"currency":"USD","usage_today":{"spend_usd":0,"topup_usd":10,"transfer_in_usd":0,"transfer_out_usd":0,"jobs":0},"entries":[{"id":"55555555-5555-4555-8555-555555555555","amount_usd":10,"kind":"topup","note":"Credit pack $10","created_at":"2026-10-20T12:00:00.000Z"}]}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, revoked, or expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"403":{"description":"The key is missing a scope, the account is frozen, or the trust tier cannot call this endpoint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/credits/checkout":{"post":{"operationId":"createCreditCheckout","tags":["Credits"],"summary":"Start a credit pack checkout","description":"Returns a Stripe Checkout URL for a pack of $5, $10, $20, $50, $100. A human pays that page by card or by USDC. A card payment is credited from checkout.session.completed when it is paid. USDC is credited from checkout.session.async_payment_succeeded for the same Checkout Session, and async_payment_failed adds nothing. The session id is the idempotency key. A new or funded agent can add $100 of packs per UTC day.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditCheckoutRequest"},"example":{"pack_usd":10}}}},"responses":{"200":{"description":"A Stripe Checkout URL a human can pay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditCheckout"},"example":{"url":"https://checkout.stripe.com/c/pay/cs_test_example","pack_usd":10}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, revoked, or expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"403":{"description":"The pack would pass the daily top-up cap.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"422":{"description":"The pack amount is not one of the published packs.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/credits/pay":{"post":{"operationId":"payMachineCredits","tags":["Credits"],"summary":"Buy a credit pack with a machine payment","description":"MPP only. Fixed packs of $5, $10, $20, $50, $100. The minimum pack is $5. Send Authorization: Bearer pp_live_… and JSON {\"pack_usd\": 10}. The first response is HTTP 402 with a WWW-Authenticate challenge for that pack price. Keep the same body and bearer key, put the MPP credential in Payment-Authorization, and retry. PostPod verifies the Stripe PaymentIntent and credits only the settled USD amount, once, keyed by that payment id. A repeat of the same payment does not credit again. New and funded agents can add $100 per UTC day. The route is off, and returns 404 feature_disabled, until STRIPE_SECRET_KEY, STRIPE_PROFILE_ID, and TEMPO_DEPOSIT_ADDRESS are set. This flow does not calculate tax.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditMachinePayRequest"},"example":{"pack_usd":10}}}},"responses":{"200":{"description":"The settled amount was credited, or this payment id was already credited.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditMachineReceipt"},"example":{"balance_usd":10,"credited_usd":10,"settled_usd":10,"pack_usd":10,"payment_intent_id":"pi_example","applied":true,"source":"machine_topup"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, revoked, or expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"402":{"description":"Payment required. A new purchase returns WWW-Authenticate with the MPP challenge for the pack price. That challenge is not the insufficient_credits problem. Pay it and retry with Payment-Authorization. A problem+json body is used when a presented payment does not match this pack.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The machine payment does not match this pack.","status":402,"detail":"The machine payment does not match this pack.","code":"payment_required","message":"The machine payment does not match this pack.","error":"The machine payment does not match this pack.","resolution":"Request a pack again. The payment was not credited."}}}},"403":{"description":"The account is frozen or the pack would pass the daily top-up cap.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"404":{"description":"Machine payments are not configured.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"409":{"description":"The payment credential was accepted but Stripe has not settled it yet.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"422":{"description":"The pack amount is not one of the published packs.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The key reached its request limit or the machine top-up attempt limit.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}},"/api/v1/credits/transfers":{"post":{"operationId":"transferCredits","tags":["Credits"],"summary":"Transfer credits to a claimed agent","description":"Moves prepaid credits from the authenticated human account to an agent account that human has claimed. The ledger writes a negative transfer and a positive transfer in one transaction. The same idempotency_key does not move credits twice.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditTransferRequest"},"example":{"account_id":"22222222-2222-4222-8222-222222222222","amount_usd":5,"idempotency_key":"transfer-2026-10-20-1"}}}},"responses":{"200":{"description":"The transfer was applied, or replayed without moving the balance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditTransfer"},"example":{"applied":true,"amount_usd":5,"balance_usd":5,"destination_account_id":"22222222-2222-4222-8222-222222222222","destination_balance_usd":5}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"401":{"description":"The API key is missing, unknown, revoked, or expired.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"402":{"description":"The human balance cannot cover the transfer.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"403":{"description":"The destination agent is not claimed by this human account.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}}},"422":{"description":"The amount or idempotency key was rejected.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/proof_of_work_failed","title":"The proof of work does not match this challenge.","status":422,"detail":"The proof of work does not match this challenge.","code":"proof_of_work_failed","message":"The proof of work does not match this challenge.","error":"The proof of work does not match this challenge.","resolution":"Request a new challenge and send a nonce whose SHA-256 digest has the required zero prefix."}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"}}},"429":{"description":"The rate limiter evaluated for this request was reached. Wait for Retry-After, then retry.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://postpodai.com/problems/invalid_api_key","title":"Unauthorized","status":401,"detail":"Send a bearer API key.","code":"invalid_api_key","message":"Send a bearer API key.","error":"Send a bearer API key.","resolution":"Create a key at https://postpodai.com/settings/api and send it as Authorization: Bearer pp_live_…"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}}}}},"components":{"headers":{"X-RateLimit-Limit":{"description":"Maximum requests in the current window for the limiter that governs this response.","required":true,"schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window after this response.","required":true,"schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"Unix epoch seconds when the current window resets.","required":true,"schema":{"type":"integer","minimum":0}},"RateLimit-Policy":{"description":"IETF RateLimit-Policy quota. Example: \"api-key\";q=60;w=60","required":true,"schema":{"type":"string"}},"RateLimit":{"description":"IETF RateLimit service limit. The t parameter is seconds until the window resets. Example: \"api-key\";r=59;t=30","required":true,"schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a 429 response.","required":true,"schema":{"type":"integer","minimum":0}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"pp_live_ or access token","description":"API key created at https://postpodai.com/settings/api, or the access token from a signed-in session. Send Authorization: Bearer with one of them. The API key is shown once. The access token is checked with the auth server. Key rotation and credit pack purchase accept only the API key. /api/mcp tool calls accept only the API key."}},"schemas":{"Problem":{"type":"object","description":"RFC 9457 problem details. code, message, and resolution are always present. title is a short label. A 401 title is Unauthorized. detail is the specific sentence, message repeats it, and error matches message for older clients.","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string","description":"Short label for the status. Unauthorized when status is 401."},"status":{"type":"integer"},"detail":{"type":"string","description":"Specific explanation for this response."},"code":{"type":"string"},"message":{"type":"string"},"error":{"type":"string","description":"Same text as message, kept for older clients."},"resolution":{"type":"string"},"job_id":{"type":"string","format":"uuid","description":"Present on script_audio_active. The job that is still queued or generating."},"job_url":{"type":"string","format":"uri","description":"Present on script_audio_active. GET this URL for the blocking job."},"top_up_url":{"type":"string","format":"uri"},"price_usd":{"type":"number"},"balance_usd":{"type":"number"}},"required":["type","title","status","detail","code","message","resolution"]},"ApiIndex":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"docs_url":{"type":"string","format":"uri"},"openapi_url":{"type":"string","format":"uri"},"llms_url":{"type":"string","format":"uri"},"llms_full_url":{"type":"string","format":"uri"},"deprecation_policy_url":{"type":"string","format":"uri"},"rate_limits_url":{"type":"string","format":"uri"},"changelog_url":{"type":"string","format":"uri"},"signup_url":{"type":"string","format":"uri"},"api_keys_url":{"type":"string","format":"uri"},"authentication":{"type":"string"},"voices":{"type":"array","items":{"$ref":"#/components/schemas/Voice"}}},"required":["name","version","docs_url","openapi_url","llms_url","llms_full_url","deprecation_policy_url","rate_limits_url","changelog_url","signup_url","api_keys_url","voices"]},"Voice":{"type":"object","description":"A Script to audio narrator. name is the display name sent on requests. The lowercase id is the same name. Deprecated voice ids are still accepted and are not returned: stock-nora → nora, stock-reed → leo, stock-sienna → kristine, stock-kai → ken, stock-mira → marko. Responses use the current id. description is the voice-picker copy. gender is female or male. Gender is confirmed by PostPod owner.","properties":{"name":{"type":"string","enum":["Nora","Leo","Kristine","Ken","Marko"]},"description":{"type":"string"},"gender":{"type":"string","enum":["female","male"],"description":"female or male. Gender is confirmed by PostPod owner."}},"required":["name","description","gender"]},"AccountDelete":{"type":"object","description":"Confirmation required to delete the account. confirm must be the exact string DELETE.","properties":{"confirm":{"type":"string","enum":["DELETE"]}},"required":["confirm"]},"PushTokenUpsert":{"type":"object","description":"Expo push token registration for the PostPod iOS app.","properties":{"token":{"type":"string","description":"ExponentPushToken[...] or ExpoPushToken[...].","examples":["ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]"]},"platform":{"type":"string","enum":["ios"]},"device_name":{"type":"string","maxLength":80,"description":"Optional device label. Omit it or send a blank string to store none."}},"required":["token","platform"]},"PushTokenDelete":{"type":"object","description":"Identifies one Expo push token to remove from this account.","properties":{"token":{"type":"string","description":"ExponentPushToken[...] or ExpoPushToken[...]."}},"required":["token"]},"PushToken":{"type":"object","description":"One saved Expo push token. Provider error text is not returned.","properties":{"id":{"type":"string","format":"uuid"},"token":{"type":"string"},"platform":{"type":"string","enum":["ios"]},"device_name":{"type":["string","null"]},"enabled":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"last_seen_at":{"type":"string","format":"date-time"}},"required":["id","token","platform","device_name","enabled","created_at","last_seen_at"]},"PushTokenResult":{"type":"object","properties":{"push_token":{"$ref":"#/components/schemas/PushToken"}},"required":["push_token"]},"Account":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":["string","null"]},"plan":{"type":"string","enum":["free","pro"]},"credits":{"$ref":"#/components/schemas/CreditBalance"},"kind":{"type":"string","enum":["human","agent"]},"tier":{"type":["string","null"],"enum":["new","funded","verified","claimed",null]},"status":{"type":"string","enum":["active","frozen"]},"limits":{"$ref":"#/components/schemas/AccountLimits"},"usage_today":{"$ref":"#/components/schemas/AccountUsage"}},"required":["id","plan","credits","kind","status","limits","usage_today"]},"CreditBalance":{"type":"object","properties":{"balance_usd":{"type":"number","description":"Prepaid USD balance."},"currency":{"type":"string","enum":["USD"]}},"required":["balance_usd","currency"]},"Show":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"handles":{"type":"array","items":{"type":"string"},"description":"X accounts this show follows. Free can follow 3. Pro can follow 25."},"topics":{"type":"array","items":{"type":"string","enum":["news","sports","ai","finance","crypto"]},"description":"Suggested topics the listener picked: news, sports, ai, finance, or crypto. The website did not store these ids before migration 034. Handles remain the accounts the episode follows."},"language":{"type":"string","enum":["en","zh","hi","es","fr","ar","bn","pt","ru","ur","id","de","ja","sw","tr","vi","ko","it","fa","th","tl","pl","nl","sv","ro","el","cs","hu","uk","no","da","fi","hr","sr","bg","sk","sl","lt","lv","et","sq","mk","mt","ga","is","bs","ca"],"description":"Stored show language. English (en) when the write omitted or left the field blank."},"voice":{"type":["string","null"],"enum":["Nora","Leo","Kristine","Ken","Marko",null]},"timezone":{"type":"string"},"delivery_hhmm":{"type":"string","enum":["00:00","00:30","01:00","01:30","02:00","02:30","03:00","03:30","04:00","04:30","05:00","05:30","06:00","06:30","07:00","07:30","08:00","08:30","09:00","09:30","10:00","10:30","11:00","11:30","12:00","12:30","13:00","13:30","14:00","14:30","15:00","15:30","16:00","16:30","17:00","17:30","18:00","18:30","19:00","19:30","20:00","20:30","21:00","21:30","22:00","22:30","23:00","23:30"]},"plan":{"type":"string","enum":["free","pro"]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","name","handles","topics","language","voice","timezone","delivery_hhmm","plan"]},"ShowWrite":{"type":"object","description":"Voice is one of Nora, Leo, Kristine, Ken, Marko, or the lowercase id nora, leo, kristine, ken, or marko. Deprecated voice ids are still accepted and are not returned: stock-nora → nora, stock-reed → leo, stock-sienna → kristine, stock-kai → ken, stock-mira → marko. Responses use the current id. Listeners pick X accounts and topics. PostPod picks the posts. topics are news, sports, ai, finance, or crypto. topic_apply replace or add fills handles from those topics using the same Free cap of 3 accounts and Pro cap of 25 as the website. Omit topic_apply to store the topic ids and the handles you sent. Credit packs are $5, $10, $20, $50, $100 and are purchased on the billing page by card or USDC stablecoin, not here.","properties":{"name":{"type":"string"},"handles":{"type":"array","items":{"type":"string"},"minItems":1,"description":"X accounts to follow. Required unless topic_apply fills them."},"topics":{"type":"array","items":{"type":"string","enum":["news","sports","ai","finance","crypto"]},"description":"Suggested topic ids. Stored in catalog order. Omit the field to leave stored topics unchanged."},"topic_apply":{"type":"string","enum":["replace","add"],"description":"replace starts from the topics. add starts from handles, or from the saved accounts when handles is omitted. Extra accounts past the plan cap are left off."},"language":{"type":"string","enum":["en","zh","hi","es","fr","ar","bn","pt","ru","ur","id","de","ja","sw","tr","vi","ko","it","fa","th","tl","pl","nl","sv","ro","el","cs","hu","uk","no","da","fi","hr","sr","bg","sk","sl","lt","lv","et","sq","mk","mt","ga","is","bs","ca"],"default":"en","description":"Language code for the daily show. Defaults to English (en) when omitted or blank. A value that is sent is validated. Free accounts are English only. Pro can use any listed language."},"voice":{"type":"string","enum":["Nora","Leo","Kristine","Ken","Marko"]},"timezone":{"type":"string","description":"IANA timezone, for example America/New_York."},"delivery_hhmm":{"type":"string","enum":["00:00","00:30","01:00","01:30","02:00","02:30","03:00","03:30","04:00","04:30","05:00","05:30","06:00","06:30","07:00","07:30","08:00","08:30","09:00","09:30","10:00","10:30","11:00","11:30","12:00","12:30","13:00","13:30","14:00","14:30","15:00","15:30","16:00","16:30","17:00","17:30","18:00","18:30","19:00","19:30","20:00","20:30","21:00","21:30","22:00","22:30","23:00","23:30"],"description":"On the hour or half-hour."}},"required":["voice","timezone","delivery_hhmm"]},"EpisodeStart":{"type":"object","description":"Optional body for starting today's episode. An empty object keeps a saved draft.","properties":{"discard_script":{"type":"boolean","description":"True drops the saved draft and writes a new script. Omit it to keep the draft."}}},"EpisodeStartResult":{"type":"object","properties":{"episode":{"$ref":"#/components/schemas/Episode"},"queued":{"type":"boolean","description":"True when the run was handed to the background worker. Poll the episode id."}},"required":["episode","queued"]},"Episode":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"show_id":{"type":"string","format":"uuid"},"delivery_date":{"type":"string","format":"date"},"status":{"type":"string","enum":["pending","generating","ready","failed","delayed","deleted"]},"duration_sec":{"type":["integer","null"]},"error":{"type":["string","null"]},"audio_url":{"type":["string","null"],"format":"uri"},"created_at":{"type":"string","format":"date-time"}},"required":["id","show_id","delivery_date","status","audio_url"]},"EpisodeDetail":{"type":"object","description":"One episode, including the script when one was saved.","properties":{"id":{"type":"string","format":"uuid"},"show_id":{"type":"string","format":"uuid"},"delivery_date":{"type":"string","format":"date"},"status":{"type":"string","enum":["pending","generating","ready","failed","delayed","deleted"]},"duration_sec":{"type":["integer","null"]},"error":{"type":["string","null"]},"audio_url":{"type":["string","null"],"format":"uri"},"created_at":{"type":"string","format":"date-time"},"script":{"type":["string","null"]}},"required":["id","show_id","delivery_date","status","audio_url","script"]},"AudioDownload":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"download_url":{"type":"string","format":"uri"},"expires_in_sec":{"type":"integer"},"content_type":{"type":"string","enum":["audio/mpeg"]}},"required":["id","download_url","expires_in_sec","content_type"]},"ScriptAudioFile":{"type":"object","description":"Multipart upload for Script to audio. file is .txt, .md, .docx, or .pdf. A PDF must be a text-based PDF. voice is Nora, Leo, Kristine, Ken, or Marko.","properties":{"file":{"type":"string","format":"binary","description":"A .txt, .md, .docx, or .pdf file. PDF is application/pdf and must begin with the PDF header."},"voice":{"type":"string","enum":["Nora","Leo","Kristine","Ken","Marko"],"description":"Narrator display name or lowercase id. Nora, Leo, Kristine, Ken, or Marko."},"input_language":{"type":"string","enum":["auto","en","zh","hi","es","fr","ar","bn","pt","ru","ur","id","de","ja","sw","tr","vi","ko","it","fa","th","tl","pl","nl","sv","ro","el","cs","hu","uk","no","da","fi","hr","sr","bg","sk","sl","lt","lv","et","sq","mk","mt","ga","is","bs","ca"],"default":"auto"},"output_language":{"type":"string","enum":["en","zh","hi","es","fr","ar","bn","pt","ru","ur","id","de","ja","sw","tr","vi","ko","it","fa","th","tl","pl","nl","sv","ro","el","cs","hu","uk","no","da","fi","hr","sr","bg","sk","sl","lt","lv","et","sq","mk","mt","ga","is","bs","ca"],"default":"en","description":"Language code for the spoken audio. Defaults to English (en) when omitted."}},"required":["file"]},"ScriptAudioExtract":{"type":"object","description":"Text read from a .txt, .md, .docx, or .pdf file, plus the same price quote as an estimate. No job is created.","properties":{"script":{"type":"string","description":"Text read from the file. Edit it before creating a job."},"filename":{"type":["string","null"]},"word_count":{"type":"integer"},"char_count":{"type":"integer"},"duration_sec":{"type":["integer","null"]},"price_usd":{"type":["number","null"]},"word_limit":{"type":"integer"},"voice":{"type":["string","null"],"enum":["Nora","Leo","Kristine","Ken","Marko",null]},"input_language":{"type":"string"},"output_language":{"type":"string"},"error_code":{"type":["string","null"]},"error_message":{"type":["string","null"]},"amount_due_usd":{"type":["number","null"],"description":"Present for an allowlisted admin key. 0 means this estimate is not charged. price_usd stays the real quote."},"complimentary":{"type":"boolean","description":"True when the key's account email is on ADMIN_EMAILS and this estimate is not charged."}},"required":["script","word_count","price_usd","voice"]},"ScriptAudioRequest":{"type":"object","properties":{"script":{"type":"string","description":"The script to speak."},"voice":{"type":"string","enum":["Nora","Leo","Kristine","Ken","Marko"],"description":"Narrator display name or lowercase id. Deprecated voice ids are still accepted and are not returned: stock-nora → nora, stock-reed → leo, stock-sienna → kristine, stock-kai → ken, stock-mira → marko. Responses use the current id."},"input_language":{"type":"string","enum":["auto","en","zh","hi","es","fr","ar","bn","pt","ru","ur","id","de","ja","sw","tr","vi","ko","it","fa","th","tl","pl","nl","sv","ro","el","cs","hu","uk","no","da","fi","hr","sr","bg","sk","sl","lt","lv","et","sq","mk","mt","ga","is","bs","ca"],"default":"auto"},"output_language":{"type":"string","enum":["en","zh","hi","es","fr","ar","bn","pt","ru","ur","id","de","ja","sw","tr","vi","ko","it","fa","th","tl","pl","nl","sv","ro","el","cs","hu","uk","no","da","fi","hr","sr","bg","sk","sl","lt","lv","et","sq","mk","mt","ga","is","bs","ca"],"default":"en","description":"Language code for the spoken audio. Defaults to English (en) when omitted. A value that is sent is validated."},"include_intro_outro":{"type":"boolean","deprecated":true,"description":"Deprecated and ignored. Sending true or false does not add an intro or outro and does not change the price. Omit it. Daily podcast episodes still include their intro and outro."}},"required":["script","voice"]},"ScriptAudioEstimate":{"type":"object","properties":{"word_count":{"type":"integer"},"char_count":{"type":"integer"},"duration_sec":{"type":["integer","null"]},"price_usd":{"type":["number","null"]},"word_limit":{"type":"integer"},"voice":{"type":["string","null"],"enum":["Nora","Leo","Kristine","Ken","Marko",null]},"input_language":{"type":"string"},"output_language":{"type":"string"},"error_code":{"type":["string","null"]},"error_message":{"type":["string","null"]},"amount_due_usd":{"type":["number","null"],"description":"Present for an allowlisted admin key. 0 means this estimate is not charged. price_usd stays the real quote."},"complimentary":{"type":"boolean","description":"True when the key's account email is on ADMIN_EMAILS and this estimate is not charged."}},"required":["word_count","price_usd","voice"]},"ScriptAudioJob":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending","queued","generating","ready","failed","deleted"]},"phase":{"type":"string","enum":["pending","paid","generating","done","failed"]},"error":{"type":["string","null"]},"duration_sec":{"type":["integer","null"]},"title":{"type":"string"},"voice":{"type":["string","null"],"enum":["Nora","Leo","Kristine","Ken","Marko",null]},"input_language":{"type":"string"},"output_language":{"type":"string"},"detected_language":{"type":["string","null"]},"word_count":{"type":"integer"},"char_count":{"type":"integer"},"price_usd":{"type":"number"},"charged_usd":{"type":["number","null"]},"source":{"type":"string","enum":["paste","upload"]},"filename":{"type":["string","null"]},"script_preview":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"},"downloadable":{"type":"boolean"},"in_progress":{"type":"boolean","description":"True while status is queued or generating, including a queued job whose progress is still null."},"download_url":{"type":["string","null"]},"progress":{"type":["number","null"],"minimum":0,"maximum":1,"description":"Fraction complete, from 0 to 1. Null before generation reports progress."},"estimated_seconds_remaining":{"type":["integer","null"],"minimum":0,"description":"Optional whole seconds until the audio is expected to be ready. Derived from chunks finished, chunks remaining, and elapsed time. Before that progress exists, it is an approximate estimate from script length and historical processing speed, and estimated_seconds_approximate is true. Null when the job is not running and during the final join and encode."},"estimated_seconds_approximate":{"type":"boolean","description":"True when estimated_seconds_remaining is the script-length prior rather than a rate from chunk progress. Clients can ignore this field."}},"required":["id","status","voice","price_usd","downloadable"]},"AccountLimits":{"type":"object","properties":{"requests_per_minute":{"type":"integer"},"jobs_per_hour":{"type":["integer","null"]},"script_word_limit":{"type":"integer"},"daily_topup_cap_usd":{"type":["number","null"]},"daily_spend_limit_usd":{"type":["number","null"]}},"required":["requests_per_minute","script_word_limit"]},"AccountUsage":{"type":"object","properties":{"spend_usd":{"type":"number"},"topup_usd":{"type":"number"},"transfer_in_usd":{"type":"number"},"transfer_out_usd":{"type":"number"},"jobs":{"type":"integer"}},"required":["spend_usd","topup_usd","jobs"]},"AgentChallenge":{"type":"object","properties":{"challenge_id":{"type":"string","format":"uuid"},"challenge":{"type":"string"},"difficulty":{"type":"integer"},"algorithm":{"type":"string","enum":["sha256-prefix"]},"expires_at":{"type":"string","format":"date-time"}},"required":["challenge_id","challenge","difficulty","algorithm","expires_at"]},"AgentSignupRequest":{"type":"object","properties":{"challenge_id":{"type":"string","format":"uuid"},"nonce":{"type":"string"},"name":{"type":"string"},"operator_email":{"type":"string","format":"email"}},"required":["challenge_id","nonce","name"]},"AgentSignup":{"type":"object","properties":{"account_id":{"type":"string","format":"uuid"},"api_key":{"type":"string","description":"Shown once. Store it before discarding the response."},"balance_usd":{"type":"number"},"tier":{"type":"string","enum":["new","funded","verified","claimed"]},"status":{"type":"string","enum":["active","frozen"]},"limits":{"$ref":"#/components/schemas/AccountLimits"},"claim_url":{"type":"string","format":"uri"},"claim_expires_at":{"type":"string","format":"date-time"}},"required":["account_id","api_key","balance_usd","tier","limits","claim_url"]},"AgentClaimLink":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"}},"required":["url","expires_at"]},"AgentEmailVerifyRequest":{"type":"object","properties":{"operator_email":{"type":"string","format":"email"},"code":{"type":"string","description":"6-digit code. Omit this field to send a code."}}},"AgentEmailVerifyResult":{"type":"object","properties":{"sent":{"type":"boolean"},"verified":{"type":"boolean"},"operator_email":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"tier":{"type":"string","enum":["new","funded","verified","claimed"]}}},"RotatedApiKey":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"api_key":{"type":"string"},"prefix":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"daily_spend_limit_usd":{"type":["number","null"]},"expires_at":{"type":["string","null"],"format":"date-time"}},"required":["id","api_key","scopes"]},"CreditAccount":{"type":"object","properties":{"balance_usd":{"type":"number"},"currency":{"type":"string","enum":["USD"]},"usage_today":{"$ref":"#/components/schemas/AccountUsage"},"entries":{"type":"array","items":{"$ref":"#/components/schemas/CreditLedgerEntry"}}},"required":["balance_usd","currency","usage_today","entries"]},"CreditLedgerEntry":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"amount_usd":{"type":"number"},"kind":{"type":"string","enum":["topup","debit","refund","transfer"]},"note":{"type":["string","null"]},"created_at":{"type":["string","null"],"format":"date-time"}},"required":["id","amount_usd","kind"]},"CreditCheckoutRequest":{"type":"object","properties":{"pack_usd":{"type":"integer","enum":[5,10,20,50,100]}},"required":["pack_usd"]},"CreditCheckout":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"pack_usd":{"type":"integer","enum":[5,10,20,50,100]}},"required":["url","pack_usd"]},"CreditMachinePayRequest":{"type":"object","properties":{"pack_usd":{"type":"integer","enum":[5,10,20,50,100]}},"required":["pack_usd"]},"CreditMachineReceipt":{"type":"object","properties":{"balance_usd":{"type":"number"},"credited_usd":{"type":"number"},"settled_usd":{"type":"number"},"pack_usd":{"type":"integer","enum":[5,10,20,50,100]},"payment_intent_id":{"type":"string"},"applied":{"type":"boolean"},"source":{"type":"string","enum":["machine_topup"]}},"required":["balance_usd","credited_usd","settled_usd","pack_usd","payment_intent_id","applied","source"]},"CreditTransferRequest":{"type":"object","properties":{"account_id":{"type":"string","format":"uuid"},"amount_usd":{"type":"number"},"idempotency_key":{"type":"string"}},"required":["account_id","amount_usd","idempotency_key"]},"CreditTransfer":{"type":"object","properties":{"applied":{"type":"boolean"},"amount_usd":{"type":"number"},"balance_usd":{"type":"number"},"destination_account_id":{"type":"string","format":"uuid"},"destination_balance_usd":{"type":"number"}},"required":["applied","amount_usd","balance_usd","destination_account_id","destination_balance_usd"]}}}}