Skip to content

internal_error

HTTP 500 · Something failed on our side.

What causes it

An unhandled failure. `detail` is deliberately generic — an unhandled downstream error can contain project identifiers and other partners’ data, so it is never echoed back.

What to do

Retry with backoff, using the **same** `Idempotency-Key` so a retry cannot double-create. If it persists, contact support with the request path and the time.

Retry?

Yes — exponential backoff with jitter.

The response

{
  "type": "https://developers.vaki.co/errors/internal_error",
  "title": "…",
  "status": 500,
  "code": "internal_error",
  "detail": "…",
  "instance": "/v1/checkout_links"
}

Branch on code, never on title or detail. The full list of codes, and the shape of the problem document, is on Errors.