---
title: "Changes to Get query execution plan explanation"
method: POST
path: "/v1/table/{id}/explain_plan"
---

# Changes to Get query execution plan explanation

`POST /v1/table/{id}/explain_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`: 2 info
- **2026-01-02** `83f8516f0507`: 2 info
- **2026-01-01** `c987c26ccb0f`: 2 info
- **2025-12-20** `5d6099d672d3`: 6 breaking, 6 warning, 6 info
- **2025-12-11** `62ebe0595c5f`: 4 breaking
- **2025-12-11** `6ad4337e3849`: 3 breaking, 4 info
- **2025-08-02** `89fbd6272646`: 1 info

## Changes

- **2026-09-14** `cb1671c5b63c`: 2 info
  - added the new optional request property `query/maximum_nprobes`
  - added the new optional request property `query/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 `query/columns/column_aliases/additionalProperties/` request property's minLength was increased from `0` to `1`
  - the `query/columns/column_names/items/` request property's minLength was increased from `0` to `1`
  - the `query/full_text_query/string_query/columns/items/` request property's minLength was increased from `0` to `1`
  - the `query/full_text_query/structured_query/query/match/column` request property's minLength was increased from `0` to `1`
  - the `query/full_text_query/structured_query/query/multi_match/match_queries/items/column` request property's minLength was increased from `0` to `1`
  - the `query/full_text_query/structured_query/query/phrase/column` request property's minLength was increased from `0` to `1`
  - the `query/vector_column` request property's minLength was increased from `0` to `1`
- **2026-06-05** `9932582b6bd7`: 2 info
  - added the new optional request property `branch`
  - added the new optional request property `query/branch`
- **2026-01-02** `83f8516f0507`: 2 info
  - added the new optional request property `context`
  - added the new optional request property `query/context`
- **2026-01-01** `c987c26ccb0f`: 2 info
  - added the new optional request property `identity`
  - added the new optional request property `query/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 `query/full_text_query/structured_query/query/match/operator`
  - removed the enum value `And` of the request property `query/full_text_query/structured_query/query/multi_match/match_queries/items/operator`
  - removed the enum value `Or` of the request property `query/full_text_query/structured_query/query/match/operator`
  - removed the enum value `Or` of the request property `query/full_text_query/structured_query/query/multi_match/match_queries/items/operator`
- **2025-12-11** `6ad4337e3849`: 3 breaking, 4 info
  - the `query/columns` request property type changed from `array` to no type
  - the response's body type changed from no type to `string` for status `200`
  - removed the required property `plan` from the response with the `200` status
  - added the new optional request property `query/columns/column_aliases`
  - added the new optional request property `query/columns/column_names`
  - the request property `query/full_text_query/structured_query/query/match/column` became optional
  - the request property `query/full_text_query/structured_query/query/multi_match/match_queries/items/column` became optional
- **2025-08-02** `89fbd6272646`: 1 info
  - endpoint added

---

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