Ref: Error Codes
The API uses standard HTTP status codes and returns a JSON body with a message describing the error.
| Status | Message Example | Description |
|---|---|---|
| 400 | Missing required parameter: q | A required parameter is missing or the input is invalid. |
| 401 | Invalid token | The Bearer token is missing, expired, or incorrect. |
| 402 | Paid plan required / Insufficient credits | The requested feature requires a paid plan, or the account has insufficient transcribe credits. |
| 404 | Episode not found | The requested resource does not exist. The error field will be not_found. |
| 404 | Episode has not been transcribed yet | The episode exists but has no processed content. The error field will be not_transcribed. |
| 404 | Translation not available | The episode is transcribed but the requested translation is not available yet. The error field will be not_translated. |
| 429 | Rate limit exceeded | Too many requests. The limit is 300 requests per hour per user. |
| 500 | Internal server error | An unexpected server error occurred. Please retry later. |
Additional Error Codes by Endpoint
Some endpoints return specific error codes:
Import Episode
| Status | Error | Description |
|---|---|---|
| 400 | — | Missing or invalid url, unsupported URL format, or podcast/channel URL provided. |
| 403 | private_episode | The Xiaoyuzhou episode is private and cannot be imported. |
| 404 | not_found | The YouTube video was not found. |
| 409 | conflict | A conflict was detected during import. Please contact support. |
| 502 | fetch_error | Failed to fetch data from the source. Please try again later. |
Upload Audio
| Status | Error | Description |
|---|---|---|
| 402 | feature_not_available | Upload audio is not available for current plan. |
Process Episode
| Status | Error | Description |
|---|---|---|
| 402 | out_of_quota | Insufficient transcribe credits. |
Ask a Question
| Status | Error | Description |
|---|---|---|
| 429 | out_of_limit | Daily ask limit exceeded for your plan. |
Send to Notion
| Status | Error | Description |
|---|---|---|
| 400 | not_connected | Notion is not connected. Connect via Podwise settings. |
| 400 | not_configured | Notion database is not configured. Configure via Podwise settings. |
| 400 | property_not_exists | A required property is missing from the Notion database. |
| 401 | unauthorized | Notion API token is invalid or expired. Reconnect via Podwise settings. |
| 404 | database_not_found | Notion database not found. Reconfigure via Podwise settings. |
| 429 | rate_limited | Notion API rate limited. Retry later. |
| 502 | notion_error | Unexpected Notion API error. |
| 504 | timeout | Notion API request timed out. |
Send to Readwise Reader
| Status | Error | Description |
|---|---|---|
| 400 | not_connected | Readwise is not connected. Configure API token via Podwise settings. |
| 401 | unauthorized | Readwise API token is invalid or expired. Reconfigure via Podwise settings. |
| 502 | readwise_error | Unexpected Readwise API error. |
Last updated on