Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Upload, list, fetch, trash and permanently delete media assets.
| Route | Method & path | What it does |
|---|---|---|
| Upload asset | POST /api/v1/assets | Uploads one file. multipart/form-data, field file. Returns 201 with the asset. |
| Bulk upload assets | POST /api/v1/assets/bulk-upload | Uploads several files. multipart/form-data, repeat files[]. Returns 201 with an array of assets. |
| Get all assets | GET /api/v1/assets | Paginated list, 24 per page. Optional page. See Pagination. |
| Get asset | GET /api/v1/assets/{assetId} | Returns one asset by id. |
| Bulk trash assets | POST /api/v1/assets/bulk-trash | Moves assets to the trash. Body { "asset_ids": [...] }. Returns 204. |
| Bulk delete assets | DELETE /api/v1/assets/bulk-permanent | Permanently deletes assets. Same body. Returns 204. Cannot be undone. |
Upload
POST /api/v1/assets returns the asset and its id.Serve
url, thumbnail_url or download_url from the asset.Trash, then delete
POST /api/v1/assets/bulk-trash, then DELETE /api/v1/assets/bulk-permanent.