Media

Get pre-signed URL for media upload

Get a pre-signed S3 URL to upload images, videos, or PDF documents. Upload the file directly to S3 via HTTP PUT, then create a post. Upload URLs expire in 1 hour. The image count per post is platform-specific (up to 4 for Twitter/X, Bluesky, Mastodon; up to 10 for Instagram, LinkedIn, Facebook, Telegram; up to 20 for Threads), or 1 video per post. Attach multiple images to the same postGroupId to form a carousel; these post-media count rules do not apply to PDF document assets.

post/get-upload-url

Headers

x-publora-user-idstring

Request body

fileNamestring required

contentTypestring required

MIME type. It must match an image/, video/, or application/pdf upload.

type'image' | 'video' | 'document'

Optional media-type hint; inferred from contentType when omitted

postGroupIdstring required

Post group to attach media to

Example request

{
  "fileName": "photo.jpg",
  "contentType": "image/jpeg",
  "type": "image",
  "postGroupId": "507f1f77bcf86cd799439011"
}

Response

Upload URL generated

successboolean

uploadUrlstring uri

Pre-signed S3 URL. PUT your file here.

fileUrlstring uri

Public URL after upload

mediaIdstring

Media record ID

Changes

No recorded changes to this endpoint across all 1 revision of this API.