Problem reference · HTTP 500

internal_error

Something unexpected failed on Talero's side. This is a bug or transient fault in the platform, not a problem with your request.

Example response

HTTP/1.1 500 Internal Server Error
Content-Type: application/problem+json
X-Request-ID: 7d1e9c2a-3b4f-4c5d-8e6f-9a0b1c2d3e4f

{
  "type": "https://docs.talero.dk/problems/internal_error",
  "title": "Internal server error",
  "status": 500,
  "detail": "An unexpected error occurred.",
  "code": "internal_error"
}

Common causes

  • An unexpected condition inside the API — these responses are logged and monitored on our side.
  • A transient database or infrastructure fault.

How to fix it

  • Retry with exponential backoff. For creates, reuse the same Idempotency-Key so a retry cannot produce a duplicate.
  • If the error is reproducible, report it to [email protected] with the X-Request-ID, the endpoint and a timestamp — that is everything we need to trace it.

If the problem persists, contact [email protected] and quote the X-Request-ID header from the failing response.