Upload Media

Uploads an image or video file to Outstand's media storage and returns a URL you can attach to posts.

POST /api/public/v1/media/upload

Supported Formats

Type	Formats	Max Size
Images	JPEG, PNG, GIF, WebP	50 MB
Videos	MP4, WebM, MOV	50 MB

File type is verified by inspecting the file's contents (magic bytes), not just its extension.

Option A — Multipart Form Upload

curl -X POST https://outstand.one/api/public/v1/media/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"

Option B — Raw Binary Upload (n8n "Send Binary Data")

Send the raw binary body with the content type header. Use the X-Filename header or ?filename= query param to set the filename:

curl -X POST "https://outstand.one/api/public/v1/media/upload?filename=photo.jpg" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary @/path/to/image.jpg

Response

{
  "url": "https://cdn.outstand.one/workspace-id/media/2026-08/abc123.jpg",
  "filename": "photo.jpg",
  "size": 245760,
  "content_type": "image/jpeg"
}

Using the URL in a Post

Pass the returned url in the media array when creating a post:

{
  "content": "Check out this photo!",
  "accounts": ["account_id"],
  "media": [{ "url": "https://cdn.outstand.one/workspace-id/media/2026-08/abc123.jpg" }]
}