internal: Internal error

Something unexpected failed inside the core. Nothing was billed for the failed call.

What to do

On the wire

HTTP 500, error type internal_error.

A client that does not send Dynamo-Error-Detail: 1 gets {"error": "internal", "detail": "internal"} on the routes that predate owner-api 1.4.0, and on the newer routes that answer in the earlier form (policies, organisations, recourse, tasks, human payments, adoption). The routes that always answer in detail (the 1.4.0 control, approval, revenue, alert and log routes, and the later webhook, main-switch, top-up, widget, payment, scoped-credential, terms, fee and child adoption routes) and the developer surfaces send errorDetail to every client. The detailed body always uses the fixed detail internal (R-432: never the underlying exception text, which can carry an RPC URL):

{
  "error": "internal",
  "detail": "internal",
  "errorDetail": {
    "type": "internal_error",
    "code": "internal",
    "message": "internal",
    "param": null,
    "doc_url": "…/errors/internal.md",
    "fix": "an unexpected error; nothing was billed for the failed call"
  }
}

See all error codes.