Create a media folder
POST/:workspace/media/folders
Creates a folder, at the root or inside another. A workspace may nest folders five levels deep, counting a root folder as the first.
Request
Responses
- 201
- 401
- 403
- 404
- 422
The created folder.
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.
Validation failed: the name repeats another folder in the same parent, the parent names no folder of this workspace, or the parent is already as deep as folders may nest.