Hello @Vas,
If I understand you want to update the same Template with multiple calls. One of the API limits is the Burst Limits, which allows the integration to trigger up to 500 API Calls every 30 seconds.
In this case, you must complete one transaction to start another. This will happen to ensure that the template will have the same properties as when the Transaction started, so it will not allow this kind of parallelism. However, you can update or create 500 templates simultaneously as these are different objects and they are isolated.
thank you for your response
The burst limit is already handled and it's not the issue here.
- Let me rephrase - for one template I need to perform only one update operation at a time. Can you confirm this, please?
- Is there anything that can be done concurrently for one single template? For example: Can I upload documents and recipients in the same time (each with separated operation)? I need to implement solution with very good performance
@Eduardo.Silva
Hello @Vas,
Maybe you're referring to "Template" as "Envelope", if you want to create multiple Envelopes from a Single Template, then you'll be limited by the Burst Limit.
If you want to update a single envelope, you'll be limited by the lock factor to ensure that you have the envelope in the same state where you begin your transaction.
You can read more about Locks, in this article:
https://www.docusign.com/blog/developers/dsdev-common-api-tasks-locking-and-unlocking-envelopes
hi Eduardo, thank you for your response. I'm familiar with docusign API model and concepts:
- I'm using eSignature API
- I need to perform updates for TEMPLATE object
- I've already handled locking - each request contain header with lock template according to documentation
- again - I'm sure burst limit is not the issue here
I need confirmation that I should perform each template update sequentially. If not then I need to know what kind of operations can be executed concurrently. For example: Can I create documents and recipients in separated requests for each of them BUT in the same time (with multiple threads).
@Eduardo.Silva
Hello @Vas,
As mentioned earlier, you cannot perform multiple updates simultaneously to the same template due to the lock mechanism. You need to commit one update to start another.
thank you
I'm using one lock (one lock token) for all my updates operation. I have no errors related to locks. I assume with this approach I need to perform sequential operations as well, right?
@Eduardo.Silva
Hello @Vas,
You're correct, as soon you commit one update, you can perform another one right away