database_query_timeout

database_query_timeout

Description

A database query timed out while an endpoint was reading or writing data.

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/database_query_timeout

Typical Causes

• The database was slow or overloaded.
• A lock or long-running query blocked the operation.
• The request touched a hot row or a large dataset.

Example

Response:

{
  "errors": [
    {
      "code": "database_query_timeout",
      "message": "Failed to create self-invested switch",
      "doc_url": "https://docs.example.com/errors/database_query_timeout"
    }
  ]
}

Premium Scheduling Note

Premium-scheduling HTTP endpoints normalize database timeouts to internal_server_error today. They do not currently emit database_query_timeout on the public API surface.

How To Fix

1. Retry if the operation is safe.
2. Check database health and slow queries.
3. Inspect application logs if the timeout repeats.