v2

Fetch URL

Use this API method to fetch a file(s) from a URL via HTTP and save it to your Sirv account. This can be any URL, either public or private (via HTTP authentication). In the url parameter, enter the full URL of the remote file. In the filename parameter, enter the folder path and filename where it should be saved e.g. /path/to/folder/new-filename.jpg. If the folder path does not already exist in your Sirv account new folder(s) will be created.

post/v2/files/fetch

Request

  • Base URL
    https://api.sirv.com
  • Auth
    none declared

Request body

urlstring required
filenamestring required
waitboolean

Example request

[
  [
    {
      "url": "https://demo.sirv.com/aurora.jpg",
      "filename": "/REST API Examples/aurora.jpg"
    },
    {
      "url": "https://demo.sirv.com/missing.jpg",
      "filename": "/REST API Examples/missing.jpg"
    }
  ]
]

Response

Successful

filenamestring
successboolean
errorstring
attemptedboolean
retryAfterstring date-time

Changes

No recorded changes to this operation across all 4 revisions of this API.