latestOpenAPI 3.0.32026-08-23410223.0 KB

c93447ba6b9d

publishing

Create presigned upload URL

Creates a presigned URL for direct file upload. Use this when you have a local file to upload rather than a publicly accessible URL. The returned presignedUrl accepts a PUT request with the file body, and publicUrl is the final media URL to use when publishing a post.

post/v2/media/uploads

Request body

filenamestring required

The filename including extension, used to determine content type.

Example request

{
  "filename": "my-video.mp4"
}

Response

Default Response

presignedUrlstring required

URL to PUT the file to. Expires after a short period.

publicUrlstring required

The final public URL of the uploaded media, to be used when creating a post.