Skip to content

Powered by Grav + Helios

List Site Media

List Site Media

GET /media
List site-level media files and folders with pagination, subfolder browsing, search, and type filtering.

Parameters

Name Type Description
page optional integer Page number for pagination (default: 1)
per_page optional integer Number of results per page (default: 20, max: 100)
path optional string Subfolder path relative to the media root directory
search optional string Recursive filename search across all subfolders
type optional string Filter by media type: image, video, audio, or document

Response Codes

200 Success
401 Unauthorized

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