---
title: "Execute a read-only SQL query"
method: POST
path: "/api/db-query"
tags: ["Debug"]
---

# Execute a read-only SQL query

`POST /api/db-query`

## Request body

- object
  - `sql` string
  - `query` string — Deprecated runtime alias for sql.
  - `params` unknown[]
    - unknown

## Response `200`

Query results

- object
  - `columns` string[], required
  - `rows` array[], required
    - unknown[]
      - unknown
  - `elapsed` number, required
  - `total` number, required

## Other responses

- `400` — Invalid or disallowed SQL

---

[API](https://skmtc.net/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.net/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/versions/e2028c1ef6f5/schema)