Upload document to request | Docusign

{
  "_links": {
    "document": {
      "href": "https://apps.docusign.com/document-public-dms/v1/accounts/aaaa1111-bbbb-2222-cccc-ddddeeee0001/api/proxy-bbbb2222-cccc-4ddd-8eee-ffff33334444"
    }
  },
  "response_metadata": {
    "request_id": "3f7c9e4b-851c-4f9b-89e7-123456789abc",
    "response_timestamp": "2026-08-26T14:30:00Z",
    "page_limit": 25
  },
  "metadata": {
    "created_at": "2026-08-26T14:30:00Z",
    "created_by": "bbbb2222-cccc-4ddd-8eee-ffff33334444",
    "modified_at": "2026-08-26T14:30:00Z",
    "modified_by": "bbbb2222-cccc-4ddd-8eee-ffff33334444"
  },
  "id": "5d4c3b2a-1f0e-4d3c-9b8a-7f6e5d4c3b2a",
  "name": "Sample Document.pdf",
  "content_type": "application/pdf",
  "current_version": 1,
  "_actions": {}
}

Uploads a new document to the specified request.

Authentication

AuthorizationBearer

Docusign OAuth 2.0 access token

Path parameters

accountIdstringRequiredformat: "uuid"

The ID of the account that owns the request statuses.

requestIdstringRequiredformat: "uuid"

The ID of the request (Agreement Desk ticket) the document belongs to.

Request

This endpoint expects a multipart form containing a file.

filefileRequired

The document file to upload.

label_idstringOptionalformat: "uuid"

The optional identifier of a document label to assign.

namestringOptional

An optional display name for the document. Defaults to the uploaded file name.

Response

The document was uploaded to the request.

_linksobjectOptional

Hypermedia links for a document resource: a PageLinks superset (paging controls, if any) plus the DMS download link.

response_metadataobjectOptional

Control information and metadata for the response.

metadataobjectOptional

Audit and provenance metadata for a resource.

idstringOptionalRead-onlyformat: "uuid"

The unique identifier of the document.

namestringOptional

The file name of the document.

content_typestringOptional

The MIME type of the document content.

current_versionintegerOptional

The current version number of the document.

labelobjectOptional

A label assigned to a document.

_actionsobjectOptional

Available actions on the document (HATEOAS). Left empty for now; reserved for future use.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

413

Content Too Large Error

415

Unsupported Media Type Error