internal: Internal error
Something unexpected failed inside the core. Nothing was billed for the failed call.
What to do
- Retry with the same
requestRef: it is billed at most once. - If it repeats, check the core's request log (
GET /owner/v1/logs), which names the route, status and reason code.
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.