Skip to main content
POST
Reserve a media upload
Write access: a member/administrator with a write-enabled credential, or an authorized signed-in user. Reserve a private image or video upload. PUT the approved file to the returned URL using its headers, then complete the upload. No post is created. Use the returned uploadUrl and headers for the separate storage PUT. Reserving an upload does not create a post. Keep signed URLs private and use them before expiry. MCP clients can use reserve_media_upload for this operation. Request conventions · API keys · MCP connections

Authorizations

Authorization
string
header
required

Personal or team Posted REST API key

Body

application/json
fileName
string
required
Required string length: 1 - 255
contentType
enum<string>
required
Available options:
image/jpeg,
image/png,
image/webp,
video/mp4,
video/quicktime
sizeBytes
integer
required
Required range: 1 <= x <= 104857600
alt
string
default:""
Maximum string length: 2000

Response

Successful response. Examples are illustrative; field values vary by record.

mediaId
string
uploadUrl
string
headers
object