---
title: "Changes to Execute SQL query"
method: POST
path: "/sql"
---

# Changes to Execute SQL query

`POST /sql`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 68 revisions.

- **2026-10-20** `36bca0ce13fe`: 1 info
- **2026-09-28** `525d811bf651`: 4 breaking
- **2026-08-31** `373e7790d059`: 1 info
- **2026-08-10** `bbeb83bf32d6`: 4 info
- **2026-07-13** `e96fb51145c6`: 1 info
- **2026-06-12** `1064868c4129`: 1 warning, 1 info
- **2026-04-15** `a2cc5189d200`: 3 info

## Changes

- **2026-10-20** `36bca0ce13fe`: 1 info
  - added the non-success response with the status `503`
- **2026-09-28** `525d811bf651`: 4 breaking
  - the `oneOf[#/components/schemas/BatchResponse]/results/items/fields/items/dataTypeID` response's property format changed from `int32` to `int64` for status `200`
  - the `oneOf[#/components/schemas/BatchResponse]/results/items/fields/items/tableID` response's property format changed from `int32` to `int64` for status `200`
  - the `oneOf[#/components/schemas/QueryResult]/fields/items/dataTypeID` response's property format changed from `int32` to `int64` for status `200`
  - the `oneOf[#/components/schemas/QueryResult]/fields/items/tableID` response's property format changed from `int32` to `int64` for status `200`
- **2026-08-31** `373e7790d059`: 1 info
  - removed the non-success response with the status `507`
- **2026-08-10** `bbeb83bf32d6`: 4 info
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the non-success response with the status `413`
- **2026-07-13** `e96fb51145c6`: 1 info
  - added the non-success response with the status `504`
- **2026-06-12** `1064868c4129`: 1 warning, 1 info
  - deleted the `header` request parameter `Connection-String`
  - the endpoint scheme security `branchConnectionString` was added to the API
- **2026-04-15** `a2cc5189d200`: 3 info
  - the endpoint scheme security `branchConnectionString` was removed from the API
  - added the new optional `header` request parameter `Connection-String`
  - removed the non-success response with the status `504`

---

[Operation](https://skmtc.dev/xataio/apis/xata-api/docs/sql/post.md) - [API](https://skmtc.dev/xataio/apis/xata-api.md) - [Page](https://skmtc.dev/xataio/apis/xata-api/changes/sql/post)