Internal error
internal_error
Something failed inside VoiceLabs that should not have. Nothing about it is your request's fault, and the failure is reported to our error tracking automatically.
Why it happens
An unhandled exception in the API layer, or a response that failed its own contract check on the way out — the server refuses to publish a payload that does not match the schema the reference promises, and reports that as our bug rather than shipping it.
How to fix it
Retry once or twice with backoff. If it persists, send support the instance path, the time, and the detail string — that is enough to find the exact trace.
Safe to retry?
Yes, with backoff. Carry an Idempotency-Key on writes: the request may or may not have had an effect before it failed.
What it looks like on the wire
{
"type": "https://voicelabs.now/errors/internal_error",
"title": "Internal error",
"status": 500,
"detail": "A human-readable explanation of this particular occurrence.",
"instance": "/v1/speech",
"code": "internal_error"
}
Branch on code, never on status or on the prose in detail: two different problems can share a status, and detail is written for humans and may be reworded. Problems a settings page can resolve also carry settings_url, and a scope failure carries required_scope.
Every VoiceLabs API error is an RFC 9457 problem document with a stable code.