Assets and Media Delivery

Import asset from URL

Downloads an image or video from a public URL into the media library. Returns 201 with a ready asset when the import finishes within about 40 seconds, otherwise 202 with status uploading while it continues in the background.

Note: On 202, poll GET /v1/assets/{assetId} until status is ready before using publicUrl as media_link. A failed import reports status failed with an error message.

Note: Files up to 1 GB. The URL must be a direct link to the file, not a web page.

post/v1/assets/import

Request

  • Base URL: https://getsocialclaw.com
  • URL: https://getsocialclaw.com/v1/assets/import
  • Auth: HTTP bearer

Request body

sourceUrlstring required

Direct public http(s) URL of the image or video file.

filenamestring nullable

Optional file name with extension. Inferred from the URL or Content-Type when omitted.

Response

Successful response.

okunknown required

Changes

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