Update a media file
PUT/:workspace/media/:media
Updates the media's name, alt_text and/or the folder it is filed in. Only the fields you include in the request body are changed; omitted fields are left untouched. A body naming none of them writes nothing and still succeeds.
Request
Responses
- 200
- 401
- 403
- 404
- 422
success reports that the request was accepted. A body naming neither field writes nothing and still returns true.
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.
Workspace or media not found.
The request body failed validation.