Media Library

List media assets

Filter, search and paginate the library. Section is a soft filter (omit = All).

get/api/v1/media

Query parameters

kind'image' | 'video'
sectionstring nullable
folderIdstring nullable

uuid or 'root'

uuid or 'root'

tagstring nullable
usedIn'pwa' | 'pwa_template' | 'landing' | 'push_template' | 'push_notification' | 'push_rule'

Consumers that can attach a media asset (usage reverse-links).

The push_* members come from pwapps-push-service via the media.usage topic — see docs/gallery/push-usage-kafka-plan.md.

searchstring nullable

Matches the filename or any of the asset's tags.

Matches the filename or any of the asset's tags.

minWidthinteger nullable

Hide images narrower than this (picker gate).

Hide images narrower than this (picker gate).

minHeightinteger nullable

Hide images shorter than this (picker gate).

Hide images shorter than this (picker gate).

archivedboolean
includeDerivedboolean
sort'createdAt' | '-createdAt' | 'size' | '-size'
pageinteger
sizeinteger

Response

Successful Response

totalinteger required
pageinteger required
sizeinteger required
pagesinteger required

Changes

No recorded changes to this endpoint across all 1 revision of this API.