Skip to main content
What each Text-to-Speech error code means, whether to retry, and how to fix it, for both REST and the WebSocket.

Error format

HTTP (including a refused WebSocket upgrade):
param is present only when one field is at fault. api_id equals the connection-id reply header. A 401 also carries WWW-Authenticate: Basic realm="plivo". On an open WebSocket, an error event:

Error codes

“Retry” means the reply has Retry-After: 1. Wait 1 second and retry. A plain GET on the Realtime URL without a WebSocket upgrade returns HTTP 426 with Upgrade: websocket. That’s a status, not an error code: connect with a WebSocket client.

WebSocket close codes

Common problems

WAV file shows a huge duration

Audio sounds like noise on a phone call

The output format doesn’t match the call. Use pcm_mulaw at 8000 Hz for Plivo calls.

Get help

Contact Plivo Support with the api_id or connection_id.