---
title: "Changes to Describe information of a table"
method: POST
path: "/v1/table/{id}/describe"
---

# Changes to Describe information of a table

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 22 of 70 revisions.

- **2026-07-01** `591cd95574b0`: 7 info
- **2026-06-23** `2bfba22949f4`: 1 info
- **2026-06-05** `9932582b6bd7`: 1 info
- **2026-04-24** `808b51fa9249`: 1 breaking, 3 info
- **2026-03-19** `2e2902c3e31b`: 1 info
- **2026-02-19** `dfa377bb2246`: 1 info
- **2026-02-19** `6e0d73e1dceb`: 1 info
- **2026-01-02** `83f8516f0507`: 1 info
- **2026-01-01** `c987c26ccb0f`: 1 info
- **2026-01-01** `bf2b77f98a25`: 1 breaking, 3 info
- **2025-12-31** `d98cd66a527b`: 4 info
- **2025-12-20** `5d6099d672d3`: 6 breaking, 6 warning, 6 info
- **2025-12-11** `6ad4337e3849`: 1 warning, 7 info
- **2025-07-31** `fa7dacb836bf`: 2 breaking
- **2025-07-29** `40a3bc489d46`: 6 breaking, 12 warning, 12 info
- **2025-07-25** `8769f8e36bc4`: 1 breaking, 2 warning, 2 info
- **2025-07-23** `1fabb1431fdd`: 1 info
- **2025-07-22** `ac7519693c52`: 4 breaking
- **2025-07-21** `db7569410aa4`: 2 breaking, 1 info
- **2025-07-17** `7658543ac78f`: 1 breaking, 1 warning
- **2025-07-14** `d649106a3ff1`: 8 info
- **2025-07-03** `d09d72ed3832`: 1 info

## Changes

- **2026-07-01** `591cd95574b0`: 7 info
  - added the optional property `context` to the response with the `200` status
  - 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-23** `2bfba22949f4`: 1 info
  - added the new optional request property `tag`
- **2026-06-05** `9932582b6bd7`: 1 info
  - added the new optional request property `branch`
- **2026-04-24** `808b51fa9249`: 1 breaking, 3 info
  - the response property `is_only_declared` became nullable for the status `200`
  - added the new optional `query` request parameter `check_declared` to all path's operations
  - added the new optional `query` request parameter `check_declared`
  - added the new optional request property `check_declared`
- **2026-03-19** `2e2902c3e31b`: 1 info
  - added the optional property `is_only_declared` to the response with the `200` status
- **2026-02-19** `dfa377bb2246`: 1 info
  - added the optional property `managed_versioning` to the response with the `200` status
- **2026-02-19** `6e0d73e1dceb`: 1 info
  - added the optional property `properties` to the response with the `200` status
- **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`
- **2026-01-01** `bf2b77f98a25`: 1 breaking, 3 info
  - the response property `location` became optional for the status `200`
  - added the new optional request property `vend_credentials`
  - the `load_detailed_metadata` request property default value `false` was removed
  - added the optional property `metadata` to the response with the `200` status
- **2025-12-31** `d98cd66a527b`: 4 info
  - added the new optional `query` request parameter `load_detailed_metadata` to all path's operations
  - added the new optional `query` request parameter `load_detailed_metadata`
  - added the new optional request property `load_detailed_metadata`
  - the response property `location` became required for the status `200`
- **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** `6ad4337e3849`: 1 warning, 7 info
  - removed the optional property `properties` from the response with the `200` status
  - added the new optional `query` request parameter `with_table_uri` to all path's operations
  - added the new optional `query` request parameter `with_table_uri`
  - added the new optional request property `with_table_uri`
  - added the optional property `namespace` to the response with the `200` status
  - added the optional property `stats` to the response with the `200` status
  - added the optional property `table` to the response with the `200` status
  - added the optional property `table_uri` to the response with the `200` status
- **2025-07-31** `fa7dacb836bf`: 2 breaking
  - the response property `schema` became optional for the status `200`
  - the response property `version` became optional for the status `200`
- **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`: 1 breaking, 2 warning, 2 info
  - the response property `location` became optional for the status `200`
  - removed the request property `name`
  - removed the request property `namespace`
  - added the new optional request property `id`
  - the response property `version` became required for the status `200`
- **2025-07-23** `1fabb1431fdd`: 1 info
  - added the optional property `storage_options` to the response with the `200` status
- **2025-07-22** `ac7519693c52`: 4 breaking
  - the request property `version` became not nullable
  - the response property `version` became optional for the status `200`
  - removed the required property `stats` from the response with the `200` status
  - removed the required property `table` from the response with the `200` status
- **2025-07-21** `db7569410aa4`: 2 breaking, 1 info
  - removed the required property `name` from the response with the `200` status
  - removed the required property `namespace` from the response with the `200` status
  - api tag `Metadata` added
- **2025-07-17** `7658543ac78f`: 1 breaking, 1 warning
  - the `schema/fields/items/type/fields` response's property type changed from `object` to `array` for status `200`
  - removed the optional property `table_uri` from the response with the `200` status
- **2025-07-14** `d649106a3ff1`: 8 info
  - added the new optional request property `version`
  - the request property `name` became optional
  - the request property `namespace` became optional
  - added the optional property `table_uri` to the response with the `200` status
  - added the required property `schema` to the response with the `200` status
  - added the required property `stats` to the response with the `200` status
  - added the required property `table` to the response with the `200` status
  - added the required property `version` to the response with the `200` status
- **2025-07-03** `d09d72ed3832`: 1 info
  - endpoint added

---

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