Upload PDF

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Uploads a PDF, stores it in Zoho WorkDrive, and prepares it for editing in Zoho PDF Editor.


PDF Input: Provide at least one of file or url. If both are provided, the multipart item processed last is used.

Endpoint

OAuth Scope

ZohoWriter.pdfEditor.ALL, WorkDrive.files.ALL, WorkDrive.organization.ALLCopied!

Request Example

cURL
cURL
Java
Python
Deluge
Copied!
curl --request POST \
  --url https://www.zohoapis.com/pdfeditor/api/v1/upload \
  --header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: multipart/form-data' \
  -F 'file=@file_path' \
  -F 'url=https://zylker.com/documents/quarterly-review.pdf' \
  -F 'folder_id=qpz9g646b2ddd954247b3988165bc17c156fe' \
  -F 'filename=Quarterly Review.pdf' \
  -F 'password=S3cur3P@ss'

Request Body

multipart/form-data
filebinary(Optional)

The PDF file to upload. The file must be no larger than 50 MB, contain no more than 400 pages, and have no page larger than 2,400 square inches. Supported formats: pdf.

Example
quarterly-review.pdf
urluri(Optional)

A publicly accessible URL from which to import the PDF. The file must be no larger than 50 MB, contain no more than 400 pages, and have no page larger than 2,400 square inches.

Example
https://zylker.com/documents/quarterly-review.pdf
Maximum Length :50005000Copied!
folder_idstring(Optional)

The alphanumeric ID of the WorkDrive folder in which to store the PDF. If omitted, the authenticated user's default folder is used. The caller must have permission to create files in the folder.

Example
qpz9g646b2ddd954247b3988165bc17c156fe
Minimum Length :1010Copied!
Maximum Length :110110Copied!
filenamestring(Optional)

The name to assign to the uploaded PDF. If omitted or blank, the source file's name is used.

Example
Quarterly Review.pdf
Maximum Length :255255Copied!
passwordstring(Optional)

The password to unlock the source PDF, if it is password-protected.

Example
S3cur3P@ss
Maximum Length :255255Copied!

Body Parameters

Copied!
// Note: payload contains multiple type attributes

// type: file
file = quarterly-review.pdf

// type: string(uri)
url = https://zylker.com/documents/quarterly-review.pdf

// type: string
folder_id = qpz9g646b2ddd954247b3988165bc17c156fe

// type: string
filename = Quarterly Review.pdf

// type: string
password = S3cur3P@ss
▼ Show full

Response Example

200
Copied!
  {
    "created_time": 1767268800000,
    "role": "OWNER",
    "owner_id": "950162",
    "parent_folder_id": "qpz9g646b2ddd954247b3988165bc17c156fe",
    "open_url": "https://pdf.zoho.com/pdfeditor/open/6yc4z4f557db79e9f446ca37f5702c8b901f6",
    "is_favourite": false,
    "document_id": "6yc4z4f557db79e9f446ca37f5702c8b901f6",
    "created_by": "Amelia",
    "version": "1.0",
    "document_name": "Quarterly Review.pdf",
    "modified_time": 1767268800000,
    "preview_url": "https://workdrive.zoho.com/file/6yc4z4f557db79e9f446ca37f5702c8b901f6",
    "lastmodified_by": [
      {
        "email_id": "amelia@zylker.com",
        "user_id": "950162",
        "display_name": "Amelia",
        "profile_photo": "https://contacts.zoho.com/file?t=user&ID=950162&fs=thumb"
      }
    ],
    "status": "Success"
  }
                
▼ Show full

Rate Limits

Duration1 minute
Threshold50
Lock Period5 minutes 30 seconds
Duration1 hour
Threshold200
Lock Period15 minutes
Duration1 day
Threshold2000
Lock Period2 hours

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.