General Errors

Invalid page number or ranges

Error code

PDF9001

Error description

This error occurs when the page numbers or range you have entered fall outside the actual number of pages in the document.

Error Response

{
    "error":  {
        "message": "Invalid page range specified. Please enter valid page numbers or ranges within the document's total page count.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9001"
    }
}

Suggested action 

Verify the total number of pages in your document and ensure the range you specify is within that limit and properly formatted.

Invalid rotation degree

Error code

PDF9002

Error description

This error occurs when the rotation degree provided is not one of the accepted values.

Error Response

{
    "error":  {
        "message": "The specified rotation degree is invalid. Please provide a valid rotation degree.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9002”
    }
}

Suggested action 

Please provide a valid rotation degreeand then try performing the action again.

Invalid rotation direction

Error code

PDF9003

Error description

This error occurs when the specified rotation direction is not recognized or supported.

Error Response

{
    "error":  {
        "message": "The PDF manipulation operation has failed due to an invalid rotation direction. Please provide a valid rotation direction.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "parameter_name": “category",
        "errorcode": "PDF9003”
    }
}

Suggested action 

Please provide a valid rotation direction and then retry the operation.

Invalid watermark type

Error code

PDF9004

Error description

This error occurs when the watermark type specified is not supported or incorrectly defined.

Error Response

{
    "error":  {
        "message": "The PDF manipulation operation has failed due to an invalid watermark type. Please provide the valid watermark type.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9004”
    }
}

Suggested action 

Please ensure you provide a valid watermark type and try performing the operation again.

Common error

Error code

PDF9005

Error description

This error indicates that the system failed to upload the processed PDF file to Zoho WorkDrive.

Error Response

{
    "error":  {
        "message": "We are currently unable to upload the manipulated PDF bytes to WorkDrive. Please ensure that you have a stable internet connection and try again. If the issue persists, kindly contact support for further assistance.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9005”
    }
}

Suggested action 

Please check your internet connection and retry the upload.

Common error

Error code

PDF9006

Error description

This error occurs when the system fails to extract images from the PDF.

Error Response

{
    "error":  {
        "message": "We are currently unable to extract the images. Please ensure that you have a stable internet connection and try again. If the issue persists, kindly contact support for further assistance.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9006”
    }
}

Suggested action 

Ensure you have a stable internet connection and try the operation again.

Invalid image format

Error code

PDF9007

Error description

This error occurs when the image provided for insertion into the PDF is in an unsupported format.

Error Response

{
    "error":  {
        "message": "The PDF manipulation operation has failed due to an invalid image format. Please provide a valid image format. If the issue persists, kindly contact support for further assistance.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9007”
    }
}

Suggested action 

Ensure that the image is in a supported format and try performing the action again.

Font size exceeded the maximum limit

Error code

PDF9008

Error description

This error occurs when the specified font size goes beyond the supported limit.

Error Response

{
    "error":  {
        "message": "The entered font size has exceeded the maximum limit. Please provide a valid font size within the allowed range.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9008”
    }
}

Suggested action 

Please enter a font size within the allowed limit of 108 and try the action again.

Uploaded PDF file is empty

Error code

PDF9009

Error description

This error occurs when the uploaded or provided PDF data is empty.

Error Response

{
    "error":  {
        "message": "The given PDF file bytes are empty. Please provide a valid PDF.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9009”
    }
}

Suggested action 

Please ensure that you are uploading a non-empty PDF file and then try performing the action again.

Invalid opacity value

Error code

PDF9010

Error description

The error occurs because an invalid opacity value has been provided in the action.

Error Response

{
    "error":  {
        "message": "Invalid opacity value provided. Opacity must be a number between 0 and 1.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9010”
    }
}

Suggested action 

Add a valid opacity value (a number between 0 and 1) and then try to perform the action again.

Common error

Error code

PDF9011

Error description

The PDF manipulation operation could not be completed due to an unexpected internal error.

Error Response

{
    "error": {
       "message": "PDF manipulation operation failed due to an internal error. Please ensure that you have a stable internet connection and try again. If the issue persists, kindly contact support for further assistance.",
       "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
       "response_generated_time": 1616134261234,
       "request_url": "https://<invoked_api_request_url>“,
       "errorcode": "PDF9011",
   }
}

Suggested action 

Verify that your internet connection is stable and try the operation again.

Invalid position value

Error code

PDF9012

Error description

The PDF manipulation operation failed because an invalid position value was provided.

{
   "error":  {
        "message": “The PDF manipulation operation has failed due to an invalid position value. Please provide valid position value. If the issue persists, kindly contact support for further assistance.”,
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/merge-api-possible-error-codes.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9012”
    }
}

Suggested action 

Add a valid position value and then retry the operation.

Mandatory JSON Object is missing

Error code

PDF9013

Error description

The PDF manipulation operation failed because a required JSON object was missing in a mandatory parameter.

{
    "error":  {
        "message": “The PDF manipulation operation has failed due to a JSON object missing inside a mandatory parameter. Please provide the mandatory JSON object and check. If the issue persists, kindly contact support for further assistance.”,
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/merge-api-possible-error-codes.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9013”
    }
}

Suggested action 

Ensure that all required input parameters, including the mandatory JSON object, are correctly provided.

Input PDF or image file is missing

Error code

PDF9014

Error description

The operation could not be completed because one or more required PDF or image files were not provided.

Error Response

{
    "error":  {
        "message": "One or more mandatory PDF or image files are missing, preventing the operation from being completed. Please ensure all required PDF or image files are present before proceeding.",
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9014”
    }
}

Suggested action 

Add the missing PDF or image files and then retry the operation.

Mandatory parameter missing

Error code

PDF9015

Error description

The operation failed because one or more mandatory parameters were not provided.

Error Response

{
    "error":  {
        "message": "One or more mandatory parameters are missing, preventing the operation from being completed. Please ensure all required parameters are provided before proceeding.”,
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9015”
    }
}

Suggested action 

Add the missing input parameter(s) and then try to perform the action again.

Insufficient credit limit

Error code

PDF9016

Error description

The operation could not be completed because the user’s available credit points are insufficient.

Error Response

{
    "error":  {
        "message": "You do not have enough credit points remaining to complete this operation. Please ensure you have sufficient credit points before proceeding.”,
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9016”
    }
}

Suggested action 

Check your current credit point balance and top up if necessary. Once you have sufficient credit points, try the operation again.

Unable to access the folder

Error code

PDF9017

Error description

The operation failed because the user does not have the necessary permissions to access the specified folder.

Error Response

{
    "error":  {
        "message": "It seems that you do not have permission to the folder you provided. Please provide a valid folder ID and try again. If the issue still persists, kindly contact support for assistance.”,
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9017”
    }
}

Suggested action 

Verify and provide a valid folder ID to which you have the required access permissions. Then, try the operation again.

Common error

Error code

PDF9018

Error description

The PDF manipulation operation failed due to an unexpected error.

Error Response

{
    "error":  {
        "message": "The PDF manipulation operation has failed due to an unexpected error. Please try again and ensure that all necessary parameters and files are provided correctly. If the issue persists, please contact support for further assistance.”,
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9018”
    }
}

Suggested action 

Bouble-check that all required parameters and files are correctly provided. Then, retry the operation.

Password validation failed 

Error code

PDF9027

Error description

The password provided does not meet the validation requirements or could not be authenticated during processing.

Error Response

{
    "error":  {
        "message": "Password validation for the uploaded PDF failed. Kindly provide valid password to proceed.”,
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "PDF9027" 
    }
}

Suggested action 

Provide a valid password for the PDF and attempt the operation again.

Insufficient permission

Error code

R3042

Error description

The document duplication operation failed because the system could not access the folder or save the duplicated file due to insufficient permissions.

Error Response

{
    "error":  {
        "message": "We couldn't duplicate this document. Please make sure you have sufficient permissions to save files to this folder.”,
        "documentation_url": "https://www.zoho.com/pdfeditor/help/api/v1/general-errors.html",
        "response_generated_time": 1594131798612,
        "request_url": “https://<invoked_api_request_url>",
        "errorcode": "R3042”
    }
}

Suggested action 

Check your permissions for the folder where you are trying to save the duplicated document.

Note: If you still find any trouble, please write to us at: support@zohopdf.com.