> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oviond.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rename media

> Change the display name of a media item.

Renaming a media item updates its display name only. The underlying file keeps the same `url`, so widgets and branding that reference the item don't need to be re-wired.

## What rename changes

* The `name` shown in the Media Library, in image pickers, and in search.

## What rename doesn't change

* The file's `url` and S3 `key` (both are immutable).
* The `size` or `mime_type`.
* Any widget or branding that references the file — it keeps working.

<Note>
  Renaming also runs as part of the upload flow: after the file uploads, Oviond confirms the item's display name with the same update call.
</Note>

## API

`PUT /v1/media/{id}` with a `name` renames the item. It returns `404` if the item doesn't exist in your account.