> ## 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.

# List media

> Browse the images in your Media Library.

The **Media Library** modal lists your uploaded images in a flat, paginated grid, most recent first. Open it from any image picker (an **Image** widget's source, a report cover, or a branding logo control), then use the **Library** tab.

## Browsing

* **Search** — the **Search media…** box matches by `name` (server-side).
* **Pagination** — the grid shows a page of items at a time, with **Prev** and **Next** controls.

## What's on a tile

| Field       | Description                                                  |
| ----------- | ------------------------------------------------------------ |
| Thumbnail   | A preview of the image.                                      |
| `name`      | The item's display name — see [Rename media](/media/update). |
| `size`      | The file size in bytes.                                      |
| `mime_type` | The image's content type.                                    |
| `url`       | The direct file URL.                                         |

## Per-item actions

Each tile has a `⋯` menu with:

* **Crop** — open the cropper to adjust the image.
* **Archive** — soft-delete the item. See [Delete media](/media/delete).

To pick an image, select a tile (or double-click) and choose **Use selected**.

## API

`GET /v1/media` lists your media, newest first, in pages. Query parameters: `page`, `limit` (max 100), `search` (matches `name`), and `folder_id`. The response includes a `meta` object with `page`, `limit`, and `total`. Soft-deleted items (`is_deleted`) are excluded.