How to Migrate from Merge and Store V1 to V2?
Why Migrate to Merge and Store V2 API?
In Merge and Store V1 API, the response is returned only after the merge operation is fully completed. However, in Deluge scripts, the maximum allowed timeout is 40 seconds. In cases where the merge takes longer, this leads to a timeout and causes the DRE workflow to fail.
To overcome this limitation, Merge and Store V2 API was introduced. In V2:
- The response is returned immediately with a virtual RID, even before the merge is completed.
- The merge operation is scheduled in the backend, and the merged document will be stored using the virtual RID.
- Users can proceed with their workflow using the virtual RID. Temporary content will be available until the final merge completes.
To track the merge status, you can use either of the following response fields:
- merge_report_data_url
- merge_report_url
The parameters and scopes remain the same as in Merge and Store V1. Additionally, V2 introduces a new optional key called merge_to inside the 'output_settings' parameter to define where the merged document should be stored.
How to Migrate from Merge and Store V1 to V2?
To migrate from Merge and Store V1 to V2, follow these key changes:
- Endpoint Update: Update the API endpoint to: https://{zohoapis_domain}/writer/api/v2/documents/{{document_id}}/merge/store
- HTTP Method: POST
- Payload Format: Pass merge data and configuration inside a JSON request body.
- Response Handling: Provides structured JSON responses with detailed status for each merged document.
For full API details, refer to the documentation: Merge and Store V2 API
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
How to merge and store documents in Zoho Writer
Ask AI to explain this article: ChatGPT | Claude | Perplexity Overview Merge and Store option allows you to automatically generate and save personalized documents for each record in your connected data source. Once the merge is complete, each ...How mail merge template works in Zoho CRM
Overview During CRM integration, when a user selects or opens any record and initiates a merge operation, a temporary document is generated from the chosen template to facilitate the merge operation with the record's data. It's crucial to note that ...How to sort data in repeat blocks in merge templates
Ask AI to explain this: ChatGPT | Perplexity | Claude Overview You can organize your repeat table data by sorting it using specific merge fields. For example, to list employees by department, and then by their date of joining within each department, ...How to generate labels with Zoho CRM data using mail merge
Navigate to Settings from CRM Home. Under customization, click Templates > Mail Merge > New Template. Select a module. Assign a name to the template and pick a folder for the template to be saved and click Create, and select Blank. Insert a table and ...Configure workflow in Zoho Books with Writer's mail merge
Overview Use Zoho Writer with Zoho Books to create branded PDFs and automate document generation from your Books data. You can either use the Zoho Writer Templates extension in Zoho Books for one‑click document generation, or configure ...
New to Zoho LandingPage?
Zoho LandingPage Resources