---
title: "Changes to Analyze query execution plan"
method: POST
path: "/v1/table/{id}/analyze_plan"
---

# Changes to Analyze query execution plan

`POST /v1/table/{id}/analyze_plan`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 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`: 4 breaking, 1 warning, 16 info
- **2025-08-02** `89fbd6272646`: 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`: 4 breaking, 1 warning, 16 info
  - added the new required request property `k`
  - added the new required request property `vector`
  - the response's body type changed from no type to `string` for status `200`
  - removed the required property `analysis` from the response with the `200` status
  - removed the request property `query`
  - added the new optional request property `bypass_vector_index`
  - added the new optional request property `columns`
  - added the new optional request property `distance_type`
  - added the new optional request property `ef`
  - added the new optional request property `fast_search`
  - added the new optional request property `filter`
  - added the new optional request property `full_text_query`
  - added the new optional request property `lower_bound`
  - added the new optional request property `nprobes`
  - added the new optional request property `offset`
  - added the new optional request property `prefilter`
  - added the new optional request property `refine_factor`
  - added the new optional request property `upper_bound`
  - added the new optional request property `vector_column`
  - added the new optional request property `version`
  - added the new optional request property `with_row_id`
- **2025-08-02** `89fbd6272646`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/lance-format/apis/lance-namespace-specification/docs/v1/table/:id/analyze_plan/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/analyze_plan/post)
