Sign in

v3

latestOpenAPI 3.1.02026-08-016689273.4 KB
File Uploads

Upload a file from a URL

Uploads a file by downloading it from the provided URL. The file will be processed asynchronously. Poll the GET endpoint to check when it's ready, then use the returned assetId in post creation.

Supported file types:

  • Images: JPEG, PNG, GIF, WebP
  • Videos: MP4, QuickTime (MOV)

File size limits:

  • Images: 10 MB max
  • GIFs: 15 MB max
  • Videos: 350 MB max

Additional constraints:

  • Images cannot exceed 36 megapixels
  • URL must be publicly accessible
post/uploads

Request body

urlstring uri required

URL of the file to upload. Must be publicly accessible.

Response

Upload job created successfully

idstring uuid

Upload job ID. Use this to poll the GET /uploads/{id} endpoint.

status'pending'

Initial status of the upload

createdAtstring date-time