---
url: /errors/database_query_timeout.md
---
# `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:

```json
{
  "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.