Upload a media file (binary)
POST/:workspace/media
Uploads a single file in one multipart/form-data request. For files larger than your instance's chunked-upload threshold (MIXPOST_CHUNKED_UPLOAD_THRESHOLD, default 10 MB), use the chunked upload flow instead.
The allowed MIME types are configured on your instance, and the maximum size depends on the file's MIME type:
video/*—MIXPOST_MAX_VIDEO_FILE_SIZE, default 200 MBimage/gif—MIXPOST_MAX_GIF_FILE_SIZE, default 15 MB- any other
image/*—MIXPOST_MAX_IMAGE_FILE_SIZE, default 15 MB - anything else — rejected
Request
Responses
- 200
- 401
- 403
- 404
- 422
The created media record. Successful uploads return HTTP 200, not 201.
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 file is missing, too large, or its MIME type is not allowed), or your workspace's media-upload limit denied the upload. A limit denial returns the usual errors.limit entry plus an extra top-level limit object describing the limit.