Media

Import media from a URL

Downloads a publicly reachable image or video into the media library and returns the media record. Use the returned url in media[].url when creating a post. Prefer this over the presign flow whenever your client cannot issue a raw HTTP PUT (e.g. an AI agent). The source URL must be public (no auth), http(s), and at most the post upload limit (250 MB); SVG and other active content is rejected.

post/v0/media/from-url

Request

  • Base URL: https://api.schedulin.app
  • URL: https://api.schedulin.app/v0/media/from-url
  • Auth: one of:
    • API key in header x-api-key
    • OAuth 2 (authorization code, authorization URL https://api.schedulin.app/oauth/authorize, token URL https://api.schedulin.app/oauth/token, scopes: media:write)

Request body

urlstring uri required
namestring
altstring nullable
contentTypestring

Response

OK

idstring required
urlstring required
namestring required
mimeTypestring required
widthinteger nullable required
heightinteger nullable required
durationinteger nullable required
createdAtstring date-time required
updatedAtstring date-time required
bucketstring required
keystring required
sizeinteger nullable required
altstring nullable required
thumbnailUrlstring nullable required

Changes

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