Welcome to Portal

?Unknown\pull-down

Welcome to Zoho Cares

Bienvenido a Soporte de Zoho

Search our knowledge base, ask the community or submit a request.

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.

3 Replies
Reply
  • Creator Certified Developer - Associate
  • 1 year ago

the regular zoho.writer.mergeAndStore integration task is available in Creator, but I see here that  zoho.writer.v2.mergeAndStore is available everywhere EXCEPT Creator.

Any reason for this? Will it be enabled in Creator? It's certainly much easier for your users/developers to use the integration tasks than to do the full API call, plus it requires more work to update the v1 call without the integration task available in Creator, so if you can please make this work in Creator that would be very helpful.

  • 1 year ago

Hello Ian, 

We hope this message finds you well.

We would like to inform you that zoho.writer.v2.mergeAndStore task is not supported in Creator. We suggest you use merge and store V2 API in creator. We are forwarding this to Creator team to enable it in Creator. 

Hope this helps. Feel free to reach us for further assistance. 

Have a great day!

Best Regards,
Sam | Customer Success Team

  • 1 year ago

Hello Ian,

As of now, certain deluge tasks (Including zoho.writer.v2.mergeAndStore task) aren't supported within the Zoho Creator service. Please be informed that we are already working on the backend library files to support those tasks and it will be available in the near future.

In case of any further clarifications, kindly write an email to support@zohocreator.com. We will check and help you accordingly.

Have a nice day!


Regards,
Zoho Creator Support Team.

Reply to Varadarajan ARA
/* */
  • 12
  • Insert
  • Plain text
Add Comment
(Up to 20 MB )