---
title: "Changes to Revert an asset to a retained version"
method: POST
path: "/api/assets/{asset_id}/versions/{version_id}/revert"
---

# Changes to Revert an asset to a retained version

`POST /api/assets/{asset_id}/versions/{version_id}/revert`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 83 revisions.

- **2026-10-16** `7c2860d9eb88`: 1 warning, 4 info
- **2026-08-18** `2c0ab3f1b985`: 1 warning, 1 info
- **2026-08-08** `815e0302a988`: 1 breaking, 1 info
- **2026-08-07** `e71db45f5d4a`: 1 info

## Changes

- **2026-10-16** `7c2860d9eb88`: 1 warning, 4 info
  - removed the optional property `metrics` from the response with the `200` status
  - added the non-success response with the status `409`
  - added the non-success response with the status `503`
  - added the optional property `quality_score` to the response with the `200` status
  - added the required property `file_size_bytes` to the response with the `200` status
- **2026-08-18** `2c0ab3f1b985`: 1 warning, 1 info
  - deleted the `query` request parameter `expected_current_version_id`
  - removed the non-success response with the status `409`
- **2026-08-08** `815e0302a988`: 1 breaking, 1 info
  - response property `detail` list-of-types was widened by adding types `string` to media type `application/json` of response `422`
  - the response property `detail` became required for the status `422`
- **2026-08-07** `e71db45f5d4a`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/gumnut-ai/apis/gumnut-api/docs/api/assets/:asset_id/versions/:version_id/revert/post.md) - [API](https://skmtc.dev/gumnut-ai/apis/gumnut-api.md) - [Page](https://skmtc.dev/gumnut-ai/apis/gumnut-api/changes/api/assets/:asset_id/versions/:version_id/revert/post)