Skip to main content
Before you attach an image or video to a post, upload it to the PostSider media library. There are two ways to do this: upload a file directly with multipart/form-data, or import a file from a public URL. Both return a media object you can pass into a post’s content. Uploaded files are stored in your instance’s configured storage backend: MinIO for the bundled Compose stack, local disk for non-Compose deployments, or Cloudflare R2 when configured. See Storage configuration for details.

​
POST /public/v1/upload

Upload a media file directly. Send the file as multipart/form-data under the field name file.

​
Request

​
file
required
The image or video file to upload, sent as multipart/form-data.

​
Example

​
Response

​
POST /public/v1/upload-from-url

Import a file from a public URL. PostSider downloads it, validates the type, and stores it in your media library.

​
Request body

​
string
required
The public URL of the image or video to import.

​
Example

​
Response

The response is the same media object shape as the direct upload.
The URL must be publicly reachable, and the file must be a supported image or video type. Private or internal addresses are blocked.

​
Using uploaded media in a post

Pass the returned media object in the image array of a post’s content when calling POST /public/v1/posts: