Upload Documents

Purpose

This API allows you to upload a PDF file to the PDF Editor, where you can edit and collaborate on the document in real time.

HTTP Request URL

https://{zohoapis_domain}/pdfeditor/api/v1/upload

Body Parameters

Parameter	Data Type	Description
Mandatory Parameters
file	File or String	Upload the PDF file using one of the following methods: Upload the input PDF file from your local drive or desktop. If the PDF file is a publicly accessible Web URL, you can pass it via the same parameter. Note: Maximum file size limit for the input PDF will be 50 MB.
Optional Parameters
filename	String	Specify a unique name for the PDF document. If this parameter is not provided, the original file name of the uploaded PDF will be used by default.
folder_id	String	The ID of the folder where you want to store the PDF document. If not provided, it will be stored in ‘My Folder’ by default.

Note: To use this API, an OAuth token should be generated with the following scope: ZohoWriter.pdfEditor.ALL, WorkDrive.files.ALL, WorkDrive.organization.ALL

Sample Request

Copiedcurl --location --request POST "https://www.zohoapis.com/pdfeditor/api/v1/upload" \
  --header "Authorization: Zoho-oauthtoken xxx.yyy.zzz" \
  --form 'file=@"/Users/username/Documents/Original.pdf"'

Sample Response

Copied {
	  "created_time": "2018-05-08T13:54:41Z",
	  "role": "OWNER",
	  "owner_id": "4579020",
	  "parent_folder_id": "40dgcFOLDER4579020",
	  "open_url": "https://pdf.zoho.com/pdfeditor/open/ponaz526afbc307254800b4308c163f376769",
	  "is_favourite": false,
	  "document_id": "ponaz526afbc307254800b4308c163f376769",
	  "created_by": “Amelia”,
	  "version": "1.0",
	  "document_name": “New PDF”,
	  "modified_time": "2018-05-08T13:54:41Z",
	  "preview_url": "https://workdrive.zoho.com/folder/xteb325bd4ff92ce2423caf22c7180b5e41ae"
	  "download_url": "https://pdf.zoho.com/api/v1/pdf/download/ponaz526afbc307254800b4308c163f376769",
	  "lastmodified_by": [
	    {
	      "email_id": “amelia@zylker.com”,
	      "profile_photo": "https://contacts.zoho.com/file?t=user&ID=4579020&fs=thumb",
	      "user_id": "4579020",
	      "display_name": “Amelia”
     }
    ]
   }