Skip to main content
GET

List media

Returns a paginated list of media (data, links, meta - same shape as List posts). Items include workspace_id, folder_id, id, url, etc.

Request

integer
Only media in this workspace (must be one you have access to).
integer
Only media in this folder (folder must belong to an accessible workspace). Do not use with root_only.
boolean
When true, only items not in any folder (folder_id null). Do not use with folder_id.
integer
Page number (default 1).
integer
Page size (default 50, max 100).

Response

200 - paginated APIMedia objects in data.

Errors

401 · 403 · 422 (invalid filters, e.g. wrong workspace or folder_id + root_only together) See Media overview.