Problem: 401 Unauthorized Error#
Token was revoked (user logged out)
Token is invalid or corrupted
Missing Authorization header
1.
Check if token is expired and refresh it
2.
Verify the Authorization header format: Bearer <token>
3.
Re-authenticate if refresh token is also expired
4.
Check if the token is URL-encoded correctly
Problem: Token Refresh Fails#
Refresh token is expired (6 months)
Refresh token was already used (token rotation)
Refresh token was revoked
1.
Re-login to get new token pair
2.
Check token expiration times
3.
Verify the refresh token is stored correctly
Problem: CORS Errors in Browser#
Frontend URL not in CORS whitelist
Missing CORS headers in preflight request
1.
Contact API administrator to whitelist your domain
2.
Use a backend proxy for development
3.
Check browser console for specific CORS errors
File size exceeds 50MB limit
Audio file type not allowed
Missing multipart/form-data content type
1.
Check file size (max 50MB for audio files)
2.
Verify audio format (wav, mp3, mp4, ogg, webm, m4a, aac, flac)
3.
Use multipart/form-data content type
4.
Ensure field name is 'file'
5.
Check that message_type is provided (prompt, whisper, voicemail, survey)
Problem: Empty or Incorrect Data#
Wrong organization ID (ouid)
Missing required query parameters
1.
Verify organization ID with your administrator
2.
Check date format (ISO 8601 UTC, e.g., 2026-01-01T00:00:00Z)
3.
Review API documentation for required parameters
Getting Help#
1.
All error responses include a requestId
Include this ID when contacting support
2.
Check browser console for client-side errors
Review server logs if you have access
3.
Include: request ID, timestamp, endpoint, error message
Modified at 2026-03-23 20:39:39
