Skip to main content
GET
Generate Pre-signed URL
Save both links from GET before uploading: use presignedUrl as the destination for the PUT request. Keep the separate url to open, download, or process the uploaded file after PUT succeeds. PUT normally returns only HTTP 200 with an empty body; it does not return another file URL.
Full reference: Generate Pre-signed URL.

Upload in two requests

  1. Generate links with this GET request. For the PUT Tester, use contenttype=application/octet-stream and enter your file name. GET does not upload any file bytes.
  2. Copy the complete presignedUrl, including its query string. Open Upload File via Pre-signed URL (PUT), paste it into the single URL field, select your local file, and send the request. Keep the returned access url for later.
The PUT sends raw bytes to storage with Content-Type: application/octet-stream and no PDF.co API key. A successful storage PUT normally returns HTTP 200 with an empty body. Then use the original access url in another PDF.co API request. The two requests do not advance or share response values automatically. Postman and cURL can also send the PUT to the complete signed URL. See the upload reference.

Authorizations

x-api-key
string
header
required

Query Parameters

name
string

File name for the generated output, the input must be in string format.

Example:

"sample.pdf"

contenttype
string<mime type>

The content type of the uploaded file

Example:

"application/octet-stream"

timeout
string

Timeout for output links in seconds.

Response

Upload and access URLs generated. The file is available only after a successful PUT. Example URLs omit signing credentials; use the complete URLs from your actual response.

presignedUrl
string<uri>

Complete signed URL for uploading raw file bytes with PUT. Keep its query string intact.

url
string<uri>

URL to use as input to conversion endpoints after the upload succeeds.

error
boolean

False when the request succeeds.

status
integer

API status code, such as 200 for success.

name
string

Uploaded filename.

Expiration timestamp for the temporary file URL.

credits
integer

Credits used by this request.

remainingCredits
integer

Credits remaining in the account.

duration
integer

Request duration in milliseconds.