Delete media files
DELETE/:workspace/media
Deletes one or more media records and detaches them from any post versions that reference them. Pass the media to delete as items, an array naming each file by its numeric id or by its uuid, at most 500 per request. Identifiers that resolve to nothing in this workspace are skipped silently, so success: true does not prove that anything was actually deleted.
Request
Responses
- 200
- 401
- 403
- 404
- 422
Deletion completed.
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.
The request body failed validation.