---
title: "Run a query"
method: POST
path: "/queries/{query_id}/runs"
tags: ["Query Runs"]
---

# Run a query

`POST /queries/{query_id}/runs`

- You must own or have permissions to the query to run it.
- Enforces a 10 second query timeout limit.

## Path parameters

- `query_id` string, required

## Request body

- object
  - `variables` object — Key-value pairs of variable names and values.

## Response `200`

Successful Run

---

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