Replace Pages from PDF

Purpose

This API allows you to replace specific pages in an original PDF with pages from a replacement PDF.

Quick Reference

Property	Value
Method	POST
Request URL	https://{zohoapis_domain}/pdfeditor/api/v1/pdf/pages/replace

Body Parameters

Parameter	Value	Mandatory/Optional	Description
original_pdf_file	File or String	Mandatory	Upload the PDF file whose pages need to be replaced, from your local drive or desktop, or via a publicly accessible web URL.
replacement_pdf_file	File or String	Mandatory	Upload the PDF file containing the replacement pages, from your local drive or desktop, or via a publicly accessible web URL.
input_options	{ "original_page_ranges": ["1-3", "5"], "replacement_page_ranges": ["1-3", "2"] }	Mandatory	original_page_ranges – Specify the page ranges in the original PDF to be replaced. replacement_page_ranges – Specify the page ranges from the replacement PDF to use.
output_settings	{ "name": "<document_name>" }	Mandatory	Specify the name for the output PDF document.

Notes and Limits

The maximum file size allowed for each input PDF is 50 MB. It cannot be more than 150 pages.
The total number of pages specified in original_page_ranges and replacement_page_ranges must be equal.
To use this API, an OAuth token should be generated with the following scopes: ZohoWriter.pdfEditor.ALL

Possible Errors

Refer to the following pages for the list of possible errors for this API:

General Errors

Sample Request

Copiedcurl --location --request POST "https://www.zohoapis.com/pdfeditor/api/v1/pdf/pages/replace" \
  --header "Authorization: Zoho-oauthtoken xxx.yyy.zzz" \
  --form 'original_pdf_file=@"/Users/username/Documents/Original.pdf"' \
  --form 'replacement_pdf_file=@"/Users/username/Documents/Replacement.pdf"' \
  --form 'input_options=“{\”original_page_ranges\”:\”1-4\",\”replacement_page_ranges\”:\”5-8\"}"' \
  --form 'output_settings=“{\”name\”:\”ModifiedFile.pdf\"}"'

Once the process begins, you will initially receive the 'status_url'. By invoking the 'status_url', you will be able to monitor the status of the scheduled job.

Sample Response

Copied{
	"status_check_url": "https://pdf.zoho.com/pdfeditor/api/v1/pdf/pages/replace/job/f931a01183b33",
	"status": "inprogress"
}

Success Response

Copied{
	"download_url": "https://pdf.zoho.com/pdfeditor/api/v1/pdf/pages/replace/download/f931a01183b33",
	"status": "success"
}