Update Link in PDF
Purpose
This API allows you to replace an existing hyperlink within a PDF.
HTTP Request URL
https://{zohoapis_domain}/pdfeditor/api/v1/pdf/annotation/link/update
Body Parameters
| Parameter | Data Type | Description |
| Mandatory Parameters | ||
| file | File or String | Upload the PDF file which needs to be password protected using one of the following methods:
Note: The maximum file size allowed for the input PDF is 50 MB. It cannot be more than 150 pages. |
| input_options | { "target_link": "https://www.cricbuzz.com", "new_link": "https://www.facebook.com", "link_style": { "color": "red", "rect_type": "visible rectangle" } } | target_link - Specify the hyperlink value of the existing hyperlinked text or area. new_link - Specify the new hyperlink value which need to be replaced. link_style (optional) - You can also specify how the link needs to be displayed (such as, color and type) using this param. |
| Optional Parameters | ||
| password |
String
| If the input PDF is password protected, specify the password to unlock it. |
Note: To use this API, an OAuth token should be generated with the following scopes: ZohoWriter.pdfEditor.ALL
Sample Request
Copiedcurl --location --request POST "https://www.zohoapis.com/pdfeditor/api/v1/pdf/annotation/link/update" \
--header "Authorization: Zoho-oauthtoken xxx.yyy.zzz" \
--form 'file=@/Users/username/Documents/Original.pdf' \
--form 'password="abc_123"' \
--form 'input_options={"target_link": "https://old.example.com", "new_link": "https://new.example.com"}' 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/annotation/link/update/job/f931a01183b33",
"status": "inprogress"
}
Success Response
Copied "download_url": "https://pdf.zoho.com/pdfeditor/api/v1/pdf/annotation/link/update/download/f931a01183b33",
"status": "success"
"response_generated_time": 17340913091019
}