Skip to main content
POST
Upload a file
Upload a media file by multipart form. Returns an id and path you can pass into a post’s image array.

Accepted MIME types

The backend inspects the file’s actual content (not just the extension) and rejects anything outside this allowlist:
TypeMIME
JPEGimage/jpeg
PNGimage/png
GIFimage/gif
WebPimage/webp
AVIFimage/avif
BMPimage/bmp
TIFFimage/tiff
MP4 videovideo/mp4
PDFs are not accepted. See Uploads troubleshooting for limits and recommended video formats.

Example

Example response:

Usage in a post

Authorizations

Authorization
string
header
required

Your Postiz API key

Body

multipart/form-data
file
file
required

The file to upload

Response

200 - application/json

File uploaded successfully

id
string

Unique file ID

name
string

File name

path
string

File URL

organizationId
string
createdAt
string<date-time>
updatedAt
string<date-time>