Skip to main content
Blog
Home/

eSignature REST API v2.0 entering maintenance mode

Author Matthew Lusher
Matthew LusherSr. Programmer Writer
Summary3 min read

One-year notice for an important change.

    • Version 2.0 transition
    • Upgrading to v2.1
      • Signature SOAP API
      • Related transition documentation
        • Additional resources

        Table of contents

        Beginning February 2022, the eSignature REST API version 2.0 will enter maintenance mode. From now until then, Docusign is progressively ending proactive maintenance of the SDK, including not only API endpoints, but documentation, SDKs, and tools. 

        Docusign recommends that all developers use the current API, version 2.1, with OAuth authentication, in all new integrations. Version 2.1 contains new features not supported in 2.0, and is the only version in which new features are introduced. However, for the foreseeable future, version 2.0 will still be active, calls to the 2.0 API will still work, and integrations using version 2.0 will still be supported. 

        Version 2.0 transition

        The following diagram details how the transition to maintenance mode for version 2.0 will be implemented:

        Schedule, version 2.0 transition to maintenance mode

        Upgrading to v2.1

        The eSignature REST API v2.1 is an incremental improvement over v2.0; you will find much that is familiar between v2 and v2.1. Thus, the costs of upgrading to v2.1 are not high, and developers will gain a host of benefits from the new version: 

        • OAuth authentication enables Single Sign On and better security.

        • Many API calls can return related data objects in a single call.

        • Many attributes that used comma-separated values in v2.0 now use proper arrays for multiple values in v2.1.

        • Envelope search options have been expanded.

        • Bulk send via the API has been improved to support templates and additional options.

        • V2.1 supports template folders and sharing, comments, and witness authentication.

        • New Docusign features will only be released for v2.1.

        Signature SOAP API

        The eSignature SOAP API will continue to be supported and is not affected by this plan.

        Additional resources

        Author Matthew Lusher
        Matthew LusherSr. Programmer Writer

        Matt has been working for Docusign since 2017. As editor for the Docusign Developer Content team, Matt edits and writes content for the Developer Center and the Developer Blog. He also composes and produces the monthly Developer Newsletter. You can reach him on LinkedIn.

        More posts from this author

        Related posts

        • How to fix duplicate tabs in Docusign: Anchor vs. custom tabs
          Developers

          How to fix duplicate tabs in Docusign: Anchor vs. custom tabs

          Author Sai Dandamudi
          Sai Dandamudi
        • Enhancing Sales Success with Strategic Insights from Salesforce and Docusign AI

          Enhancing Sales Success with Strategic Insights from Salesforce and Docusign AI

          Author Subbarao Pydikondala
          Subbarao Pydikondala
        • From the Trenches: Automating JWT OAuth in Insomnia

          From the Trenches: Automating JWT OAuth in Insomnia

          Author Robert Schendle
          Robert Schendle
        How to fix duplicate tabs in Docusign: Anchor vs. custom tabs

        How to fix duplicate tabs in Docusign: Anchor vs. custom tabs

        Author Sai Dandamudi
        Sai Dandamudi
        Enhancing Sales Success with Strategic Insights from Salesforce and Docusign AI

        Enhancing Sales Success with Strategic Insights from Salesforce and Docusign AI

        Author Subbarao Pydikondala
        Subbarao Pydikondala
        From the Trenches: Automating JWT OAuth in Insomnia

        From the Trenches: Automating JWT OAuth in Insomnia

        Author Robert Schendle
        Robert Schendle

        Discover what's new with Docusign IAM or start with eSignature for free

        Explore Docusign IAMTry eSignature for Free
        Person smiling while presenting