---
title: "[Beta] Run a sql query as supabase_read_only_user"
method: POST
path: "/v1/projects/{ref}/database/query/read-only"
tags: ["Database"]
---

# [Beta] Run a sql query as supabase_read_only_user

`POST /v1/projects/{ref}/database/query/read-only`

All entity references must be schema qualified.

## Path parameters

- `ref` string, required

## Request body

- V1ReadOnlyQueryBody
  - `query` string, required
  - `parameters` unknown[]
    - unknown

## Response `201`

## Other responses

- `401` — Unauthorized
- `403` — Forbidden action
- `429` — Rate limit exceeded
- `500` — Failed to run read-only sql query

---

[API](https://skmtc.dev/supabase/apis/management-api.md) · [All operations](https://skmtc.dev/supabase/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supabase/management-api/revisions/a7cb39418064/schema)