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: PDFs are not accepted. Limits and recommended video formats: Uploads troubleshooting.

Example

Example response:

Usage in a post

Authorizations

Authorization
string
header
required

Your PostQueen 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

Stored file name

originalName
string | null

The name the file was uploaded under

path
string

Public URL of the file. This is the value to send as an attachment

thumbnail
string | null

Thumbnail URL, set for video

alt
string | null

Alt text, when one was set