--- title: "Changes to Query a table" method: POST path: "/v1/table/{id}/query" --- # Changes to Query a table `POST /v1/table/{id}/query` > Every recorded change to this operation, newest first. ## Timeline Changed in 16 of 70 revisions. - **2026-09-14** `cb1671c5b63c`: 2 info - **2026-07-01** `591cd95574b0`: 6 info - **2026-06-10** `a3308034a3cd`: 7 breaking - **2026-06-05** `9932582b6bd7`: 1 info - **2026-01-02** `83f8516f0507`: 1 info - **2026-01-01** `c987c26ccb0f`: 1 info - **2025-12-20** `5d6099d672d3`: 6 breaking, 6 warning, 6 info - **2025-12-11** `62ebe0595c5f`: 4 breaking - **2025-12-11** `6ad4337e3849`: 2 breaking, 4 info - **2025-07-29** `40a3bc489d46`: 6 breaking, 12 warning, 12 info - **2025-07-25** `8769f8e36bc4`: 20 breaking, 2 warning, 1 info - **2025-07-22** `ac7519693c52`: 3 info - **2025-07-21** `db7569410aa4`: 1 info - **2025-07-21** `6790486d1fac`: 1 breaking, 2 warning, 7 info - **2025-07-17** `7658543ac78f`: 4 breaking, 19 info - **2025-07-14** `d649106a3ff1`: 1 info ## Changes - **2026-09-14** `cb1671c5b63c`: 2 info - added the new optional request property `maximum_nprobes` - added the new optional request property `minimum_nprobes` - **2026-07-01** `591cd95574b0`: 6 info - added the optional property `context` to the response with the `400` status - added the optional property `context` to the response with the `401` status - added the optional property `context` to the response with the `403` status - added the optional property `context` to the response with the `404` status - added the optional property `context` to the response with the `503` status - added the optional property `context` to the response with the `5XX` status - **2026-06-10** `a3308034a3cd`: 7 breaking - the `columns/column_aliases/additionalProperties/` request property's minLength was increased from `0` to `1` - the `columns/column_names/items/` request property's minLength was increased from `0` to `1` - the `full_text_query/string_query/columns/items/` request property's minLength was increased from `0` to `1` - the `full_text_query/structured_query/query/match/column` request property's minLength was increased from `0` to `1` - the `full_text_query/structured_query/query/multi_match/match_queries/items/column` request property's minLength was increased from `0` to `1` - the `full_text_query/structured_query/query/phrase/column` request property's minLength was increased from `0` to `1` - the `vector_column` request property's minLength was increased from `0` to `1` - **2026-06-05** `9932582b6bd7`: 1 info - added the new optional request property `branch` - **2026-01-02** `83f8516f0507`: 1 info - added the new optional request property `context` - **2026-01-01** `c987c26ccb0f`: 1 info - added the new optional request property `identity` - **2025-12-20** `5d6099d672d3`: 6 breaking, 6 warning, 6 info - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `400` - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `401` - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `403` - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `404` - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `503` - the `code` response property's min was decreased from `400.00` to `0.00` for the response status `5XX` - removed the optional property `type` from the response with the `400` status - removed the optional property `type` from the response with the `401` status - removed the optional property `type` from the response with the `403` status - removed the optional property `type` from the response with the `404` status - removed the optional property `type` from the response with the `503` status - removed the optional property `type` from the response with the `5XX` status - the response property `code` became required for the status `400` - the response property `code` became required for the status `401` - the response property `code` became required for the status `403` - the response property `code` became required for the status `404` - the response property `code` became required for the status `503` - the response property `code` became required for the status `5XX` - **2025-12-11** `62ebe0595c5f`: 4 breaking - removed the enum value `And` of the request property `full_text_query/structured_query/query/match/operator` - removed the enum value `And` of the request property `full_text_query/structured_query/query/multi_match/match_queries/items/operator` - removed the enum value `Or` of the request property `full_text_query/structured_query/query/match/operator` - removed the enum value `Or` of the request property `full_text_query/structured_query/query/multi_match/match_queries/items/operator` - **2025-12-11** `6ad4337e3849`: 2 breaking, 4 info - the `columns` request property type changed from `array` to no type - removed the media type `application/vnd.apache.arrow.stream` for the response with the status `200` - added the new optional request property `columns/column_aliases` - added the new optional request property `columns/column_names` - the request property `full_text_query/structured_query/query/match/column` became optional - the request property `full_text_query/structured_query/query/multi_match/match_queries/items/column` became optional - **2025-07-29** `40a3bc489d46`: 6 breaking, 12 warning, 12 info - the response property `type` became optional for the status `400` - the response property `type` became optional for the status `401` - the response property `type` became optional for the status `403` - the response property `type` became optional for the status `404` - the response property `type` became optional for the status `503` - the response property `type` became optional for the status `5XX` - removed the optional property `status` from the response with the `400` status - removed the optional property `status` from the response with the `401` status - removed the optional property `status` from the response with the `403` status - removed the optional property `status` from the response with the `404` status - removed the optional property `status` from the response with the `503` status - removed the optional property `status` from the response with the `5XX` status - removed the optional property `title` from the response with the `400` status - removed the optional property `title` from the response with the `401` status - removed the optional property `title` from the response with the `403` status - removed the optional property `title` from the response with the `404` status - removed the optional property `title` from the response with the `503` status - removed the optional property `title` from the response with the `5XX` status - added the optional property `code` to the response with the `400` status - added the optional property `code` to the response with the `401` status - added the optional property `code` to the response with the `403` status - added the optional property `code` to the response with the `404` status - added the optional property `code` to the response with the `503` status - added the optional property `code` to the response with the `5XX` status - added the optional property `error` to the response with the `400` status - added the optional property `error` to the response with the `401` status - added the optional property `error` to the response with the `403` status - added the optional property `error` to the response with the `404` status - added the optional property `error` to the response with the `503` status - added the optional property `error` to the response with the `5XX` status - **2025-07-25** `8769f8e36bc4`: 20 breaking, 2 warning, 1 info - the request property `bypass_vector_index` became not nullable - the request property `distance_type` became not nullable - the request property `ef` became not nullable - the request property `fast_search` became not nullable - the request property `filter` became not nullable - the request property `full_text_query/string_query/columns` became not nullable - the request property `full_text_query/structured_query/query/match/column` became not nullable - the request property `full_text_query/structured_query/query/match/fuzziness` became not nullable - the request property `full_text_query/structured_query/query/multi_match/match_queries/items/column` became not nullable - the request property `full_text_query/structured_query/query/multi_match/match_queries/items/fuzziness` became not nullable - the request property `full_text_query/structured_query/query/phrase/column` became not nullable - the request property `lower_bound` became not nullable - the request property `nprobes` became not nullable - the request property `offset` became not nullable - the request property `prefilter` became not nullable - the request property `refine_factor` became not nullable - the request property `upper_bound` became not nullable - the request property `vector_column` became not nullable - the request property `version` became not nullable - the request property `with_row_id` became not nullable - removed the request property `name` - removed the request property `namespace` - added the new optional request property `id` - **2025-07-22** `ac7519693c52`: 3 info - added the new optional `query` request parameter `delimiter` to all path's operations - added the new optional `query` request parameter `delimiter` - added the media type `application/vnd.apache.arrow.file` for the response with the status `200` - **2025-07-21** `db7569410aa4`: 1 info - api tag `Data` added - **2025-07-21** `6790486d1fac`: 1 breaking, 2 warning, 7 info - the `vector` request property type changed from `array` to no type - removed the request property `full_text_query/columns` - removed the request property `full_text_query/query` - added the new optional request property `full_text_query/string_query` - added the new optional request property `full_text_query/structured_query` - added the new optional request property `vector/multi_vector` - added the new optional request property `vector/single_vector` - the request property `columns` became nullable - the request property `full_text_query` became nullable - the request property `vector` became nullable - **2025-07-17** `7658543ac78f`: 4 breaking, 19 info - removed the enum value `cosine` of the request property `distance_type` - removed the enum value `dot` of the request property `distance_type` - removed the enum value `l2` of the request property `distance_type` - the `refine_factor` request property format changed from no format to `int32` - added the new optional request property `fast_search` - added the new optional request property `full_text_query` - added the new optional request property `lower_bound` - added the new optional request property `upper_bound` - added the new optional request property `vector_column` - the request property `bypass_vector_index` became nullable - the request property `distance_type` became nullable - the request property `ef` became nullable - the request property `filter` became nullable - the request property `nprobes` became nullable - the request property `offset` became nullable - the request property `prefilter` became nullable - the request property `refine_factor` became nullable - the request property `version` became nullable - the request property `with_row_id` became nullable - the `ef` request property's min was decreased from `1.00` to `0.00` - the `k` request property's min was decreased from `1.00` to `0.00` - the `nprobes` request property's min was decreased from `1.00` to `0.00` - the `refine_factor` request property's min was decreased from `1.00` to `0.00` - **2025-07-14** `d649106a3ff1`: 1 info - endpoint added --- [Operation](https://skmtc.dev/lance-format/apis/lance-namespace-specification/docs/v1/table/:id/query/post.md) - [API](https://skmtc.dev/lance-format/apis/lance-namespace-specification.md) - [Page](https://skmtc.dev/lance-format/apis/lance-namespace-specification/changes/v1/table/:id/query/post)