---
title: "Changes to Query a data source"
method: POST
path: "/v1/data_sources/{data_source_id}/query"
---

# Changes to Query a data source

`POST /v1/data_sources/{data_source_id}/query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 16 of 39 revisions.

- **2026-10-26** `52686c6832a8`: 2 info
- **2026-10-21** `981cafc786b6`: 2 info
- **2026-10-19** `cdb48b858846`: 1 breaking, 1 warning
- **2026-10-09** `4544d132b1d9`: 3 breaking, 3 info
- **2026-10-08** `c62657944234`: 2 breaking, 3 info
- **2026-09-03** `86a6ebe86320`: 1 info
- **2026-08-15** `c90a4587bc95`: 1 warning
- **2026-08-14** `e2c5c8c5dcd1`: 2 breaking, 1 warning, 2 info
- **2026-08-13** `ae20477af71b`: 1 breaking, 1 info
- **2026-08-12** `28d140865fc6`: 2 warning
- **2026-08-11** `a5b52dca751e`: 2 info
- **2026-08-06** `8525ba8f25df`: 3 breaking
- **2026-08-05** `0470d9397de2`: 1 breaking
- **2026-08-04** `06b66c7458c6`: 1 info
- **2026-07-31** `301eea0116d9`: 2 warning
- **2026-07-26** `681ee94f046c`: 3 warning

## Changes

- **2026-10-26** `52686c6832a8`: 2 info
  - added the required property `results/items/anyOf[subschema #2]/anyOf[#/components/schemas/dataSourceObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[subschema #6: Relation]/relation/allOf[#/components/schemas/databasePropertyRelationConfigResponseCommon]/limit` to the response with the `200` status
  - added the required property `results/items/anyOf[subschema #2]/anyOf[#/components/schemas/partialDataSourceObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[subschema #6: Relation]/relation/allOf[#/components/schemas/databasePropertyRelationConfigResponseCommon]/limit` to the response with the `200` status
- **2026-10-21** `981cafc786b6`: 2 info
  - added the required property `results/items/anyOf[subschema #2]/anyOf[#/components/schemas/dataSourceObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[subschema #5: Status]/status/default_option` to the response with the `200` status
  - added the required property `results/items/anyOf[subschema #2]/anyOf[#/components/schemas/partialDataSourceObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[subschema #5: Status]/status/default_option` to the response with the `200` status
- **2026-10-19** `cdb48b858846`: 1 breaking, 1 warning
  - the `page_size` request property type changed from `number` to `integer`
  - the `page_size` request property's min was set to `1.00`
- **2026-10-09** `4544d132b1d9`: 3 breaking, 3 info
  - removed `subschema #1` from the `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #7: Status]/status` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `filter/anyOf[subschema #1]/` request property `anyOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #21: Rollup]/rollup` request property `anyOf` list
  - added `#/components/schemas/statusValueFilter` to the `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #7: Status]/status` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `filter/anyOf[subschema #1]/` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #21: Rollup]/rollup` request property `anyOf` list
- **2026-10-08** `c62657944234`: 2 breaking, 3 info
  - removed `subschema #1, subschema #2` from the `filter/anyOf[subschema #1]/` request property `anyOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #21: Rollup]/rollup` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `filter/anyOf[subschema #1]/` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #21: Rollup]/rollup` request property `anyOf` list
  - added `subschema #3` to the `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #7: Status]/status/anyOf[subschema #1]/` request property `anyOf` list
- **2026-09-03** `86a6ebe86320`: 1 info
  - added the required property `results/items/anyOf[subschema #2]/anyOf[#/components/schemas/dataSourceObjectResponse]/database_type` to the response with the `200` status
- **2026-08-15** `c90a4587bc95`: 1 warning
  - added the new `idempotency_key_reused` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
- **2026-08-14** `e2c5c8c5dcd1`: 2 breaking, 1 warning, 2 info
  - removed `subschema #1, subschema #2` from the `filter/anyOf[subschema #1]/` request property `anyOf` list
  - the `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #22: Verification]/verification` request property type changed from `object` to no type
  - removed the request property `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #22: Verification]/verification/status`
  - added `#/components/schemas/verificationPropertyStatusFilter, #/components/schemas/verificationPropertyDoesNotEqualFilter` to the `filter/anyOf[#/components/schemas/propertyFilter]/anyOf[subschema #22: Verification]/verification` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `filter/anyOf[subschema #1]/` request property `anyOf` list
- **2026-08-13** `ae20477af71b`: 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3` to the response body `oneOf` list for the response status `403`
  - removed `#/components/schemas/publicApiCommonErrorResponse, subschema #2` from the response body `allOf` list for the response status `403`
- **2026-08-12** `28d140865fc6`: 2 warning
  - added the new `agent_credit_limit_reached` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
  - added the new `workspace_credits_exhausted` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
- **2026-08-11** `a5b52dca751e`: 2 info
  - added `subschema #1, subschema #2` to the `results/items/` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `results/items/` response property `anyOf` list for the response status `200`
- **2026-08-06** `8525ba8f25df`: 3 breaking
  - added `#/components/schemas/unsupportedFormulaPropertyValueResponse` to the `results/items/anyOf[subschema #1]/anyOf[#/components/schemas/pageObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[#/components/schemas/partialRollupPropertyResponse]/rollup/allOf[subschema #2]/oneOf[subschema #3: Array]/array/items/oneOf[#/components/schemas/simplePropertyValueResponse]/oneOf[subschema #15: Formula]/formula` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/unsupportedFormulaPropertyValueResponse` to the `results/items/anyOf[subschema #1]/anyOf[#/components/schemas/pageObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[#/components/schemas/simpleOrArrayPropertyValueResponse]/oneOf[#/components/schemas/simplePropertyValueResponse]/oneOf[subschema #15: Formula]/formula` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/unsupportedPartialRollupValueResponse` to the `results/items/anyOf[subschema #1]/anyOf[#/components/schemas/pageObjectResponse]/properties/additionalProperties/allOf[subschema #2]/oneOf[#/components/schemas/partialRollupPropertyResponse]/rollup/allOf[subschema #2]/` response property `oneOf` list for the response status `200`
- **2026-08-05** `0470d9397de2`: 1 breaking
  - request body became required
- **2026-08-04** `06b66c7458c6`: 1 info
  - request body became optional
- **2026-07-31** `301eea0116d9`: 2 warning
  - added the new `invalid_beta` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
  - added the new `invalid_credit_limit` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
- **2026-07-26** `681ee94f046c`: 3 warning
  - added the new `agent_deleted` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
  - added the new `directory_not_found` enum value to the `allOf[subschema #2]/code` response property for the response status `404`
  - added the new `status_change_not_allowed` enum value to the `allOf[subschema #2]/code` response property for the response status `403`

---

[Operation](https://skmtc.dev/notion/apis/notion-api/docs/v1/data_sources/:data_source_id/query/post.md) - [API](https://skmtc.dev/notion/apis/notion-api.md) - [Page](https://skmtc.dev/notion/apis/notion-api/changes/v1/data_sources/:data_source_id/query/post)