Replace PDF Pages
Replaces a page range in a PDF with a page range from another PDF and makes the modified PDF available for download.
Endpoint
OAuth Scope
curl --request POST \
--url https://www.zohoapis.com/pdfeditor/api/v1/pdf/pages/replace \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: multipart/form-data' \
-F 'original_pdf_file=@file_path' \
-F 'replacement_pdf_file=@file_path' \
-F 'input_options={
"original_page_ranges": [
"2-4"
],
"replacement_page_ranges": [
"2-4"
]
}' \
-F 'output_settings={
"name": "updated-contract.pdf"
}'Request Body
multipart/form-dataThe original PDF whose pages are replaced, uploaded directly or imported from a publicly accessible URL. 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. Its filename must not exceed 255 characters. Supported formats: pdf.
The replacement PDF containing the pages to insert, uploaded directly or imported from a publicly accessible URL. 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. Its filename must not exceed 255 characters. Supported formats: pdf.
Configures the original and replacement page ranges used in the page replacement.
{
"original_page_ranges": [
"2-4"
],
"replacement_page_ranges": [
"2-4"
]
}Show Sub-Attributes
Identifies the page range to replace in the original PDF. This array accepts at most one page-range expression.
[
"2-4"
]Identifies the page range to use from the replacement PDF. This array accepts at most one page-range expression.
[
"2-4"
]Configures the filename of the modified PDF.
{
"name": "updated-contract.pdf"
}Show Sub-Attributes
The filename for the modified PDF. A .pdf extension is appended when the name does not already end with one.
// Note: payload contains multiple type attributes
// type: file
original_pdf_file = original-contract.pdf
// type: file
replacement_pdf_file = updated-contract-pages.pdf
// type: object
input_options = {
"original_page_ranges": [
"2-4"
],
"replacement_page_ranges": [
"2-4"
]
}
// type: object
output_settings = {
"name": "updated-contract.pdf"
} {
"status": "inprogress",
"status_check_url": "https://www.zohoapis.com/pdfeditor/api/v1/pdf/pages/replace/job/7cd22f5d9e58f3ed313ce6b277e2d4877b6d56525cc0a3c5b67024aa73b7bbff39868b542b475ab613ed883209c3a2a3"
}
Rate Limits
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.