List media folders
GET/:workspace/media/folders
Returns the workspace's whole folder tree in one response, ordered by name. Each folder names its parent by uuid, and reports how many files are filed at or below it.
A folder is a label rather than a place: filing a media item under one never moves the file on disk, and the same file is reachable at the same URL whichever folder it sits in.
Request
Responses
- 200
- 401
- 403
- 404
The folder tree.
The bearer token is missing, malformed, unknown, or expired.
The token is valid, but the user it belongs to may not perform this action:
- they are not a member of the
{workspace}in the path; or - their workspace role is too low for this endpoint (write routes require Admin or Member); or
- for
/panelendpoints, they are not a platform administrator.
The host application that Mixpost is installed into can also deny access to Mixpost as a whole, which produces the same response.
The {workspace} UUID in the path does not match any workspace.