Media

Fetch media from a public URL

Fetch an image or video from a public HTTP(S) URL into posterly storage. The fetcher blocks localhost, private IPs, embedded credentials, and redirect chains that resolve to private networks.

post/api/v1/media/upload-from-url

Request

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

Request body

urlstring uri required
filenamestring nullable
content_typestring nullable
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.

Example request

{
  "url": "https://example.com/launch.jpg",
  "filename": "launch.jpg"
}

Response

Remote media uploaded successfully

urlstring required
pathstring required
source_urlstring required
content_typestring required
sizeinteger required

Example response

{
  "url": "https://assets.poster.ly/users/123/launch.jpg",
  "path": "users/123/launch.jpg",
  "source_url": "https://example.com/launch.jpg",
  "content_type": "image/jpeg",
  "size": 245678
}

Changes

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