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

# Changes to Describe information about a transaction

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 70 revisions.

- **2026-07-01** `591cd95574b0`: 7 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`: 5 info
- **2025-07-29** `40a3bc489d46`: 6 breaking, 12 warning, 12 info
- **2025-07-25** `8769f8e36bc4`: 2 breaking, 1 info
- **2025-07-21** `db7569410aa4`: 1 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-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`: 5 info
  - removed the `CANCELED` enum value from the `status` response property for the response status `200`
  - removed the `FAILED` enum value from the `status` response property for the response status `200`
  - removed the `QUEUED` enum value from the `status` response property for the response status `200`
  - removed the `RUNNING` enum value from the `status` response property for the response status `200`
  - removed the `SUCCEEDED` enum value from the `status` response property for the response 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`: 2 breaking, 1 info
  - the `id` request property type changed from `string` to `array`
  - removed the required property `id` from the response with the `200` status
  - the request property `id` became optional
- **2025-07-21** `db7569410aa4`: 1 info
  - api tag `Metadata` added
- **2025-07-03** `d09d72ed3832`: 1 info
  - endpoint added

---

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