Skip to content

Powered by Grav + Helios

Media

Media

Endpoints for managing media files attached to pages and site-level media.

Endpoints for managing media files attached to pages and site-level media.

List Page Media

Upload Page Media

Send the file as a multipart/form-data request rather than JSON. The Content-Type header should be set to multipart/form-data.

Delete Page Media

List Site Media

Returns media files and folders from the user/media directory. Supports browsing subfolders via the path parameter, recursive search via search, and filtering by file type via type. The response includes a folders array in the meta object listing immediate subdirectories at the current p...

Upload Site Media

Upload one or more files to the user/media directory. Use the path query parameter to upload into a subfolder. The request body should use multipart/form-data with a file field. Maximum upload size per file is 64 MB.

Delete Site Media

Remove a file and its .meta.yaml sidecar (if present) from the user/media directory. The filename parameter supports subfolder paths.

Create Media Folder

Create a new folder in the user/media directory. Parent directories are created automatically. The request body must include a path property with the relative folder path to create.

Delete Media Folder

Remove an empty folder from the user/media directory. The folder must contain no files or subdirectories.

Rename Site Media

Rename a file or move it to a different folder within user/media. Both from and to are relative paths. The destination directory is created automatically if needed. Any .meta.yaml sidecar file is also moved.

Rename Media Folder

Rename a folder within the user/media directory. All contents of the folder are preserved. Both from and to are relative paths from the media root.