Upload 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. See Uploads troubleshooting for limits and recommended video formats.

curl -X POST "https://api.postiz.com/public/v1/upload" \
  -H "Authorization: your-api-key" \
  -F "file=@photo.jpg"

Example response:

{
  "id": "01HXYZ123ABCDEF",
  "path": "https://uploads.postiz.com/photo.jpg"
}

{
  "image": [
    {
      "id": "01HXYZ123ABCDEF",
      "path": "https://uploads.postiz.com/photo.jpg"
    }
  ]
}