Skip to content

internal_server_error โ€‹

internal_server_error

Description โ€‹

An unexpected server-side error occurred while handling the request.

HTTP Status โ€‹

500 Internal Server Error

doc_url Format โ€‹

The doc_url value is an absolute URL and changes by environment:

<docs-base-url>/errors/internal_server_error

Typical Causes โ€‹

  • A downstream dependency is unavailable.
  • The operation failed due to an unexpected runtime condition.
  • A transient infrastructure issue interrupted processing.

Example โ€‹

Response:

json
{
  "errors": [
    {
      "code": "internal_server_error",
      "message": "An unexpected error occurred",
      "doc_url": "https://docs.example.com/errors/internal_server_error"
    }
  ]
}

How To Fix โ€‹

  1. Retry if the operation is safe and idempotent.
  2. Check service status, logs, and downstream dependency health.
  3. Contact platform support if the error persists.