Reverts an S3 object to a specific prior version by performing a server-side copy.

Behavior: Creates a new latest version of the object whose content is identical
to the specified historical version. The bucket name and object key are resolved from the
asset record. No data is downloaded or uploaded — the operation is entirely server-side.
Once the new version is created, the existing S3-event notification pipeline automatically
re-registers the asset in DynamoDB and Elasticsearch.

Delete markers: Delete markers cannot be reverted to using this endpoint. To
undelete a file whose current version is a delete marker, use
POST /admin/asset/history/undelete instead.

Authorization: Requires a valid Bearer token. Caller must be a System Administrator.

Error Scenarios: Returns 400 if required fields are missing, the asset was not
found, or the specified version does not exist. Returns 401 if the caller is not authenticated.
Returns 403 if the caller is not a System Administrator.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

The revert request containing the asset ID and version ID.

Request body for reverting an S3 object to a specific previous version.

uuid

Gets or sets the ID of the asset to revert. Required.
The bucket name and object key are resolved from the asset record.

string | null

Gets or sets the S3 version ID to restore as the new current version.
Must be a real content version — delete markers cannot be reverted to directly.
Use the undelete endpoint to remove a delete marker instead. Required.

Headers
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json