Create media (multipart upload)

Uploads a media file as raw binary via multipart/form-data. This is the

recommended path for large or binary files: the client streams the file
directly instead of base64-encoding it in the browser (which crashes the tab
on 100+ MB uploads).

Same endpoint as Create media (POST /api/medias) — the server auto-detects
the multipart path when a binary file part is present. For the JSON (base64 /
fromUrl) modes, see that request.

Do not set the Content-Type header manually: the client must send
multipart/form-data with a boundary (Bruno does this automatically).

Form Parts

PartTypeRequiredDescription
filebinaryYesThe raw file to upload (streamed). Max 200 MB.
namestringNoFile name with extension. Defaults to the uploaded file's original name.
folderstringNoFolder/category. Defaults to Medias.

mime, size, thumbnail and path are derived server-side from the stored
object — do not send them. Thumbnails are generated automatically for images.

Response Fields

FieldTypeDescription
idintegerNewly created media unique identifier
namestringFile name
urlstringPublic URL to access the file
mimestringMIME type (derived from the stored file)
folderstringFolder/category
pathstringStorage path
thumbnailstringThumbnail URL (generated for images)
thumbPathstringThumbnail storage path
createdAtdatetimeCreation timestamp
updatedAtdatetimeLast update timestamp

Response

  • 201 Created: Media successfully uploaded
  • 401 Unauthorized: Invalid or missing API key
  • 413 Payload Too Large: File exceeds the 200 MB upload limit
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Responses
201

Resource created

400

Bad request

401

Unauthorized

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here!