---
title: "Changes to Execute an RQL query"
method: POST
path: "/v1/query"
---

# Changes to Execute an RQL query

`POST /v1/query`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 7 revisions.

- **2026-03-01** `30999982e9d4` — 1 breaking, 3 warning, 1 info
- **2026-01-31** `180d59085b78` — 1 warning, 1 info
- **2026-01-30** `9404aa4fdc22` — 1 breaking, 1 warning, 5 info

## Changes

- **2026-03-01** `30999982e9d4` — 1 breaking, 3 warning, 1 info
  - the `explain` response's property type changed from `object` to no type for status `200`
  - removed the optional property `explain/estimated_rows` from the response with the `200` status
  - removed the optional property `explain/indexes_used` from the response with the `200` status
  - removed the optional property `explain/steps` from the response with the `200` status
  - added `#/components/schemas/QueryPlan` to the `explain` response property `allOf` list for the response status `200`
- **2026-01-31** `180d59085b78` — 1 warning, 1 info
  - removed the optional property `documents/items/author` from the response with the `200` status
  - added the optional property `documents/items/metadata` to the response with the `200` status
- **2026-01-30** `9404aa4fdc22` — 1 breaking, 1 warning, 5 info
  - the `explain` response's property type changed from no type to `object` for status `200`
  - removed the optional property `documents/items/metadata` from the response with the `200` status
  - added the optional property `documents/items/author` to the response with the `200` status
  - added the optional property `explain/estimated_rows` to the response with the `200` status
  - added the optional property `explain/indexes_used` to the response with the `200` status
  - added the optional property `explain/steps` to the response with the `200` status
  - removed `#/components/schemas/QueryPlan` from the `explain` response property `allOf` list for the response status `200`

---

[Operation](https://skmtc.dev/brainfish-ai/apis/reasondb-api/docs/v1/query/post.md) · [API](https://skmtc.dev/brainfish-ai/apis/reasondb-api.md) · [Page](https://skmtc.dev/brainfish-ai/apis/reasondb-api/changes/v1/query/post)