Troubleshooting

401 Unauthorized

Confirm header is exactly Authorization: Bearer <api-key>, key contains no surrounding quotes or spaces, and key was not regenerated.

400 Bad Request

Check call IDs, pagination values, date format, date ordering, time zone, and repeated query parameters.

404 Not Found

Confirm resource belongs to workspace bound to API key. Call can exist without available recording.

416 Range Not Satisfiable

Remove Range header or request bytes inside audio length shown by Content-Range.

429 Too Many Requests

Honor Retry-After. Coordinate workers and ReadMe testing because quota is workspace-wide.

502 Bad Gateway

Recording provider could not serve audio. Retry with backoff.

ReadMe Try It does not send request

• Confirm API key and required parameters are filled.
• Confirm browser request targets Sonik Cloud Run, not ReadMe proxy.
• Check browser console for CORS or network errors.
• Retry on trusted network without privacy extension blocking request.

Preserve x-request-id and x-correlation-id from failed response for diagnosis. No public integration-support destination is published yet.