database_query_timeout

database_query_timeout

Description

A database query timed out while the endpoint was reading or writing switching 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"
    }
  ]
}

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.