# media

> Media library: signed uploads, scan, renditions, signed read URLs.

Media library: signed uploads, scan, renditions, signed read URLs.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/media` | `media_list`: Media library | `media:write` | - |
| POST | `/v1/media:from-url` | `media_from_url`: Fetch a public URL into the library | `media:write` | - |
| DELETE | `/v1/media/{media_id}` | `media_delete`: Delete media | `media:write` | - |
| GET | `/v1/media/{media_id}` | `media_get`: Get media | `media:write` | - |
| PATCH | `/v1/media/{media_id}` | `media_update`: Rename, alt text, tags, move into the library | `media:write` | - |
| POST | `/v1/media/{media_id}/complete` | `media_upload_complete`: Finish an upload | `media:write` | - |
| POST | `/v1/media/{media_id}/transcode` | `media_transcode`: Request a rendition | `media:write` | - |
| GET | `/v1/media/{media_id}/url` | `media_url_get`: Signed read URL (up to 1 hour) | `media:write` | - |
| GET | `/v1/media/{media_id}/usages` | `media_usages_list`: Where a file is used | `media:write` | - |
| POST | `/v1/media/uploads` | `media_upload_create`: Create an upload | `media:write` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
