Tandem

Problem types

500

Unexpected internal error

https://tandem.codingful.com/problems/internal-error

What it means

Something failed that the Admin API did not anticipate — most often the database being unreachable underneath it.

The detail is deliberately generic and always the same string. An error response is not a debugging channel: the specifics, including the stack trace, go to the application's logs, where they are not exposed to whoever can reach the endpoint.

What to do

Read the application logs for the real cause. Before retrying a write operation — replay, discard, pause — re-read the message or relay state: the call may have applied before the failure, and these operations are not idempotent in the sense of being safe to fire blindly twice.

Example

{
  "type": "https://tandem.codingful.com/problems/internal-error",
  "title": "Unexpected internal error",
  "status": 500,
  "detail": "An unexpected error occurred; see server logs for detail"
}