Upload Files from Local or Public URL, API Tool

Try Now with API Lab

Start right from your browser - upload files, choose parameters, generate code, and send API Calls directly from API Lab!

Request

POST

Headers

Api-Key

Don't have a key? Create an account to get one.

Response-Type

Poll for the status of a request by ID. Request IDs can be found in the JSON response of POST requests sent to any pdfRest endpoint.

Required Parameters

file

File to be uploaded. This parameter may be included multiple times to upload multiple files but may not be combined with 'url' parameter.

url

Public URL address for a file. This parameter may be included multiple times to upload multiple files from different URLs but may not be combined with 'file' parameter.

Code

curl -X POST "https://api.pdfrest.com/upload" \ 
  -H "Accept: application/json" \ 
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \

Response

The response for your API Call will display here.

Once you've sent your POST request and received a valid response, you can download your output file using the output URL.

Build Your Solution

You have document processing problems, we have Solutions. Explore the many ways pdfRest can align your documents with your business objectives.

Browse all solutions

Integrate pdfRest with Microsoft Power Automate

Integrate PDF API Tools with Salesforce Apex Code

Control your Backend with pdfRest API Toolkit Self-Hosted

Why does pdfRest API offer the most convenient file uploads?

pdfRest offers the best solution for uploading files for processing, because it supports multiple files at once, upload from URL, and intuitive responses for easy resource tracking.

Multiple Files at Once

Easily upload many files with one API Call. There is no limit to the number of files you may upload at once. Choose between uploading files from local storage or files from public URLs. Receive a response with convenient reference IDs associated with each file to use for subsequent processing steps. Note that a file size limit applies to the total of all files included in the call - see your plan details on the Pricing page for more information about upload file size limits.

Upload from URL

If your files are hosted somewhere accessible by public URL, you can easily pass those URLs into the Upload Files API Tool without the need to download them to your own local storage first. pdfRest will directly download files from specified URLs to the processing server, saving you time and avoiding unnecessary storage requirements. You can even pass multiple URLs with the same call to upload many files from URL at once!

Keep Track of Uploads

Streamline your workflow by pre-uploading files before processing. The Upload Files API Tool makes it easy to upload files in advance and store information about each uploaded file. This tool returns a JSON response intuitively arranged to help you associate your uploaded file names with their generated resource IDs. These resource IDs can be used to initiate subsequent processing steps for uploaded files.

Start from Code Examples

See more code examples in our GitHub repository

Need more help?

Start with a Tutorial for step-by-step guidance

How to Upload a Single Binary File to pdfRest in .NET with C#

How to Upload Multiple Files to pdfRest in .NET with C#

2 items

Customize Your Solution

Learn about the parameters for this tool to create your custom solution.

File

Local file to be uploaded.

This parameter may be included multiple times to upload multiple files but may not be combined with url parameter.

See Documentation