Skip to main content

Replace Asset Content from URI

POST 
/api/v1/assets/:asset_id/content/original/replace/external

Replace an asset's original file with one FileSpin downloads from an HTTPS URL, keeping the Asset ID. It behaves like Replace Asset Content — the same permissions, formats and content versioning — with the file fetched for you.

Different host for uploads

This endpoint is served on https://upload.filespin.io — not the standard https://app.filespin.io host used by the rest of the API. Make sure your client targets the upload host for this request.

The URL follows the rules of Ingest from URI: a public download link, no private or internal addresses, and a sign-in or HTML page in place of the file is refused with the same error codes. name is optional and read from the link when omitted.

The file is downloaded while the request waits, so this suits documents and images; replace a very large file with the multipart replace.

Example request JSON payload​

{
  "key": "https://example.com/files/brochure-v2.pdf"
}

The response is the same as Replace Asset Content's.

Request​

Responses​

Replaced