Media

Ingest media from a public URL

Fallback when the caller cannot PUT to a presigned URL. SocialRobot fetches a public https image/video URL, or a ChatGPT client-injected file.download_url, and stores it. Do not send file://, workspace paths, or placeholder hosts such as example.com. Prefer POST /media/upload-url plus PUT when the client can upload itself. Max 50MB.

post/media/from-url

Request

  • Base URL: https://socialrobot.io/api/v1
  • URL: https://socialrobot.io/api/v1/media/from-url
  • Auth: API key in header x-api-key

Request body

sourceUrlstring

Public https URL that already serves this image or video. Do not invent a URL, and do not use example.com. Do not pass file:// or workspace paths. Use only when you cannot PUT to the presigned URL from get_media_upload_url.

filenamestring

Original filename including extension, if the source URL has none

contentTypestring

MIME type hint when the source does not send one

Response

Media stored successfully

keystring required

The storage key for the uploaded media

urlstring required

The public URL to pass into create_post

contentTypestring required

The stored MIME type

Changes

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