Merge and Store v1 API depreciation

Merge and Store v1 API depreciation

Hi Zoho Writer users,

 

The Merge and Store v1 API allows you to store the merged document in Zoho WorkDrive. The response of this API will be returned with the document's ID only after the merge is complete.

 

In Deluge, the maximum timeout for operation is 40 seconds. In some cases, the merge operation will exceed 40 seconds and the Deluge workflow may fail.

 

To overcome this problem we're introducing an advanced version of this API: Merge and Store v2 and sunsetting the v1 version of this API.

 

The Merge and Store v2 API will return the response immediately with a virtual document ID in which the merge operation will be scheduled in the background. Users can use this virtual ID and proceed with their workflow.

 

The parameters and scopes are same with the addition of merge_to optional key in the output_settings parameter. To know about the request URL and response structure please refer.

 

Here's how the response structure will be for v1 API and v2 API:

 

v1 API sample response

 

{

"document_id": "ponazfea04477109f4681a831e7177d96bc40",

"document_url": "http://writer.zoho.com/writer/open/ponazfea04477109f4681a831e7177d96bc40",

"status": “success”

}

 

 

v2 API sample response

 

{

    "merge_report_data_url": "<url>",

    "merge_report_url": "<url>",

    "records": [

        {

            "data": [{“given input merge_data”}],

            "download_link": "<attachment download url>",

            "document_id": "<merged doc id>",

            "document_url": "<merged doc open url>",

            "status": "inprogress"

        }

    ],

    "status": "inprogress"

}

 

We'll be sunsetting the Merge and Store v1 API on December 31, 2023. Please move to v2 API before this date to avoid any interruption in your workflow.

 

Please let us know if you have any questions.

 

Regards,

Team Writer.

    Zoho Developer Community






                              Zoho Desk Resources

                              • Desk Community Learning Series


                              • Digest


                              • Functions


                              • Meetups


                              • Kbase


                              • Resources


                              • Glossary


                              • Desk Marketplace


                              • MVP Corner


                              • Word of the Day



                                  Zoho Marketing Automation
                                          • Sticky Posts

                                          • Merge and Store v1 API depreciation

                                            Hi Zoho Writer users, The Merge and Store v1 API allows you to store the merged document in Zoho WorkDrive. The response of this API will be returned with the document's ID only after the merge is complete. In Deluge, the maximum timeout for operation
                                          • Zoho Creator Developer's Conference 2017 !!!

                                            We welcome all our Creator Developers! You're invited to join us for our annual Zoholics Developers conference August 29th–31st! This is your chance to get training and guidance on Zoho Creator from our most knowledgeable custom app builders.       Zoholics Developers is a three-day event where you'll participate in interactive workshops to hone your app-building skills, get questions answered by Creator experts with personal one-on-one sessions, and connect with other Creator developers from around
                                          • Share your success story

                                            We would like to hear from our passionate users how much Zoho Creator has changed the way you work and benefited you. If you would like to share your story to us and be featured as a proud user of Zoho Creator, then this is for you. Fill up the form below and if you want to be included in a case study, we will get in touch with you to get further details. So what are you waiting for? Tell us your story. Charles


                                          Manage your brands on social media



                                                Zoho TeamInbox Resources

                                                  Zoho DataPrep Resources



                                                    Zoho CRM Plus Resources

                                                      Zoho Books Resources


                                                        Zoho Subscriptions Resources

                                                          Zoho Projects Resources


                                                            Zoho Sprints Resources


                                                              Qntrl Resources


                                                                Zoho Creator Resources


                                                                  Zoho WorkDrive Resources



                                                                    Zoho Campaigns Resources

                                                                      Zoho CRM Resources

                                                                      • CRM Community Learning Series

                                                                        CRM Community Learning Series


                                                                      • Tips

                                                                        Tips

                                                                      • Functions

                                                                        Functions

                                                                      • Meetups

                                                                        Meetups

                                                                      • Kbase

                                                                        Kbase

                                                                      • Resources

                                                                        Resources

                                                                      • Digest

                                                                        Digest

                                                                      • CRM Marketplace

                                                                        CRM Marketplace

                                                                      • MVP Corner

                                                                        MVP Corner

                                                                      





                                                                      




                                                                          Design. Discuss. Deliver.

                                                                          Create visually engaging stories with Zoho Show.

                                                                          Get Started Now