Media

Upload media directly

Compatibility upload endpoint for small image/video files up to 5MB decoded. Large uploads should use /api/v1/media/signed-upload so the file can go directly to storage. PDFs are not accepted on this relay route: use /api/v1/media/signed-upload (up to 50MB, for LinkedIn document posts).

post/api/v1/media/upload

Request

Base URL: https://www.poster.ly
URL: https://www.poster.ly/api/v1/media/upload
Auth: HTTP bearer

Request body

filenamestring required

datastring required

Base64-encoded file bytes

content_typestring

workspace_idstring

Optional. The workspace this call acts in and whose plan and credits it uses (from whoami). Needed only when the key can act in several workspaces.

Response

Media uploaded successfully

urlstring required

pathstring required

asset_idstring nullable

Registered media asset id. Uploads are analyzed automatically in the background; null when analysis registration was skipped.

Example response

{
  "url": "https://assets.poster.ly/users/123/hero.jpg",
  "path": "users/123/hero.jpg",
  "asset_id": "2f9b6a51-6f0e-4b58-9a5b-64b3a3f2f9d1"
}

Changes

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