Document, File & System

Upload File from URL

Downloads file from a source url and uploads it as a temporary file. Temporary files are automatically permanently removed after 1 hour.

get/v1/file/upload/url

Request

  • Base URL
    https://api.pdf.co
  • URL
    https://api.pdf.co/v1/file/upload/url
  • Auth
    API key in header x-api-key

Query parameters

urlstring required

URL of the file to upload.

namestring

The name the file will be stored with.

httpusernamestring
httppasswordstring

Response

Success.

statusstring

Status of the API response.

messagestring

Descriptive message for the response status.

urlstring uri

URL to the output file.

jobIdstring

Unique identifier for the job.

creditsinteger

Credits used for this operation.

remainingCreditsinteger

Credits remaining after this operation.

durationinteger

Time taken to complete the request, in milliseconds.

Example response

{
  "status": "success",
  "message": "Success",
  "url": "https://pdf-temp-files.s3.us-west-2.amazonaws.com/output.pdf",
  "jobId": "6YSZD3U872ZYYFEDMQCQSGEEO8YSF5WA",
  "credits": 2,
  "remainingCredits": 1480582,
  "duration": 33
}

Changes

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