Upload a media file (binary)
POST/:workspace/media
Uploads a single file in one multipart/form-data request. For files larger than 10 MB, use the chunked upload flow instead.
The maximum size depends on the file's MIME type:
video/*— 200 MBimage/gif— 15 MB- any other
image/*— 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 {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.