List media files

GET 
/:workspace/media

Returns a paginated list of the workspace's media, newest first (ordered by created_at descending).

Files sharing a created_at have no further tiebreaker, so a page boundary that falls between them can repeat or skip one. De-duplicate by id when walking every page.

Request

Responses

200

Paginated media collection.

401

The bearer token is missing, malformed, unknown, or expired.

403

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 /panel endpoints, 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.

404

The {workspace} UUID in the path does not match any workspace.