---
title: "Changes to Run a structured query across one or more tables"
method: POST
path: "/tables/query"
---

# Changes to Run a structured query across one or more tables

`POST /tables/query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 13 revisions.

- **2026-08-27** `04621d9c0274`: 1 info
- **2026-07-26** `3b86731e7a59`: 1 breaking, 2 info

## Changes

- **2026-08-27** `04621d9c0274`: 1 info
  - added the optional property `truncated` to the response with the `200` status
- **2026-07-26** `3b86731e7a59`: 1 breaking, 2 info
  - added `#/components/schemas/CellSuccess, #/components/schemas/CellError, #/components/schemas/CellPending, #/components/schemas/CellEmpty` to the `data/items/additionalProperties/` response property `oneOf` list for the response status `200`
  - request property `query/filter/anyOf[#/components/schemas/FilterPredicate]/value/anyOf[subschema #4]/items/` list-of-types was widened by adding types `number` to media type `application/json`
  - removed `#/components/schemas/CellSuccess, #/components/schemas/CellError, #/components/schemas/CellPending, #/components/schemas/CellEmpty` from the `data/items/additionalProperties/` response property `anyOf` list for the response status `200`

---

[Operation](https://skmtc.dev/clay/apis/clay-public-api/docs/tables/query/post.md) - [API](https://skmtc.dev/clay/apis/clay-public-api.md) - [Page](https://skmtc.dev/clay/apis/clay-public-api/changes/tables/query/post)