---
title: "Run a read query"
method: POST
path: "/client/apps/{id}/database/queries"
tags: ["App data"]
---

# Run a read query

`POST /client/apps/{id}/database/queries`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/apps/{id}/database/queries`
- Auth: HTTP bearer

Read-only. Returns a run id; poll `GET /database/queries/{runId}` for the result. Requires `data:read`.

## Path parameters

- `id` string, uuid, required

## Request body

- object

## Response `202`

The run id. (Response shape not yet modelled in this spec.)

- object

## Other responses

- `400`: The statement is not read-only
- `404`: No such app, or no database

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)