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

# Media Library

> Manage media assets (images, videos, files) via the CMS API

The Media Library stores all media assets used across your content. Media items are referenced by ID in post fields like `banner_url`.

## Media Object

| Field       | Type         | Editable | Required | Description                                                   |
| ----------- | ------------ | -------- | -------- | ------------------------------------------------------------- |
| `id`        | integer      | No       | —        | Unique media identifier                                       |
| `filename`  | string       | Yes      | Yes      | Filename with extension, matching the uploaded or linked file |
| `alt_text`  | string       | Yes      | No       | Alt text for images                                           |
| `caption`   | string       | Yes      | No       | Media caption                                                 |
| `path`      | string (URL) | No       | Yes      | Media object URL                                              |
| `source`    | string       | Yes      | No       | Source/credit for the media                                   |
| `type`      | string       | No       | —        | `Image`, `Video`, or `File` (default: `Image`)                |
| `meta_data` | object       | Yes      | No       | Metadata (width, height, etc.)                                |
| `date`      | string       | No       | —        | Date added to library                                         |
| `member`    | string       | No       | —        | Member who uploaded the media                                 |

## Endpoints

| Method                                                                 | Endpoint               | Description                    |
| ---------------------------------------------------------------------- | ---------------------- | ------------------------------ |
| [GET](/dxp/api-reference/content-management/media/list-media)          | `/media-library/`      | List all media                 |
| [POST](/dxp/api-reference/content-management/media/register-media-url) | `/media-library/`      | Register an existing media URL |
| [POST](/dxp/api-reference/content-management/media/upload-media-file)  | `/media-library/`      | Upload a media file            |
| [GET](/dxp/api-reference/content-management/media/retrieve-media)      | `/media-library/{id}/` | Retrieve media                 |
| [PATCH](/dxp/api-reference/content-management/media/update-media)      | `/media-library/{id}/` | Update media metadata          |
| [DELETE](/dxp/api-reference/content-management/media/delete-media)     | `/media-library/{id}/` | Delete media                   |