API template library

Simulate the DocuSign Agreement Desk API

A WireMock simulation of DocuSign's REST API — covering legal intake requests, request types and their form fields, request statuses, document uploads, sharing, and following.

Vendor
DocuSign
Functionality
Legal intake requests, documents, sharing
Spec version
1.0.0
Endpoints
13
Stubs
51
Protocol
REST
Validation
AI-validated Before publication, an AI agent exercised these endpoints against the real DocuSign API through WireMock's recording proxy, and the recorded traffic was used to verify each stub's request and response shapes.

Live sandbox · no signup, no API key

DocuSign Agreement Desk API

A running WireMock Cloud instance of this template, callable right now from a terminal, a script, or an AI agent.

Base URL
https://zmkwdw.wiremockapi.cloud

GET List open legal requests

curl -s -X GET 'https://zmkwdw.wiremockapi.cloud/v1/accounts/2f5a7c9e-1b3d-4f6a-8c2e-4a6b8d0f2a41/requests?state=Open' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

POST File an NDA request

curl -s -X POST 'https://zmkwdw.wiremockapi.cloud/v1/accounts/2f5a7c9e-1b3d-4f6a-8c2e-4a6b8d0f2a41/requests' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Mutual NDA - Bloom & Branch","intake_form_id":"6f7a8b9c-0d1e-4f2a-8b3c-4d5e6f7a8b01","owner_id":"c3d5e7f9-1a2b-4c3d-8e4f-5a6b7c8d9e01","intake_form_fields":{"counterparty_name":"Bloom & Branch","nda_type":"Mutual"}}'

GET List request types (intake forms)

curl -s -X GET 'https://zmkwdw.wiremockapi.cloud/v1/accounts/2f5a7c9e-1b3d-4f6a-8c2e-4a6b8d0f2a41/request-types' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Method Path Summary
GET /v1/accounts/{accountId}/request-statuses List request statuses
GET /v1/accounts/{accountId}/request-types List request types
GET /v1/accounts/{accountId}/request-types/{requestTypeId}/fields List request type fields
GET /v1/accounts/{accountId}/requests List requests
POST /v1/accounts/{accountId}/requests Create a request
GET /v1/accounts/{accountId}/requests/{requestId} Get a request
POST /v1/accounts/{accountId}/requests/{requestId}/actions/follow Follow a request
POST /v1/accounts/{accountId}/requests/{requestId}/actions/unfollow Unfollow a request
GET /v1/accounts/{accountId}/requests/{requestId}/documents List documents on a request
POST /v1/accounts/{accountId}/requests/{requestId}/documents Upload a document to a request
GET /v1/accounts/{accountId}/requests/{requestId}/shares List the principals a request is shared with
POST /v1/accounts/{accountId}/requests/{requestId}/shares/actions/add Share a request with principals
POST /v1/accounts/{accountId}/requests/{requestId}/shares/actions/remove Remove principals from a request

Unauthenticated WireMock Cloud demo sandbox for DocuSign — not an official DocuSign sandbox, and it returns simulated example data only.

What's inside the Agreement Desk template

Agreement Desk is DocuSign's legal intake queue, where business teams file requests that legal then works through. Here the Lucky Shrub Sales account starts with two of them: AR-1001, a completed mutual NDA with a signed PDF, and AR-1002, a supplier agreement sitting in Legal Review with a draft DOCX attached. A new request comes back as AR-1003 in the New status, with Avery Lucky as submitter and a MANAGE share, an owner resolved to a full participant record, and _links for its collection and itself. Errors use the problem-details shape the spec defines, with a code and a target field in each entry of the errors array.

  • Requests — create, read and list newest first, with Open and Closed filtering and ctoken paging
  • Request types — NDA Request and Supplier Agreement intake forms with typed fields, plus a disabled Contract Renewal
  • Statuses — New, Legal Review and Ready for Signature in the Open state; Completed and Cancelled in Closed
  • Documents — multipart uploads with content type taken from the extension and a per-request count
  • Collaboration — role grants and revocations on a request, and follow and unfollow actions

DocuSign Agreement Desk mock API FAQ

Three intake rules are enforced. nda_type must be Mutual or Unilateral (otherwise 400 invalid_field_value), the reference number is read-only (400 read_only_field), and filing against the disabled Contract Renewal type answers 422 intake_form_not_active. Other fields are stored without checks and aren't echoed back.

Any accountId is accepted and acts as its own empty account, numbering its requests from AR-1001. Data stays under the id it was written to, so fetching AR-1002's request id under a different account answers 404 request_not_found. A typo in the account id therefore looks like an empty queue rather than an error.

Not through the API: there is no status-change operation, so requests you file stay New. The seeded pair covers the other states, AR-1002 in the Open state's Legal Review and AR-1001 in the Closed state's Completed, which is enough to exercise state=Open and state=Closed filtering.

Requests with no Authorization header get a 401 with code unauthorized; any Bearer string gets through. Requests you file are visible to every other visitor, so keep titles and counterparty names fictional.

Vendor names identify APIs represented by WireMock template sources. This page does not imply vendor endorsement, certification, partnership, or official integration status.