This method initiates a new chunked upload with the first part of the content.

Request

HTTP request

POST /v2.1/accounts/{accountId}/chunked_uploads

Parameters

Parameter NameValueDescription
Path Parameters
accountIdstring

The external account number (int) or account ID GUID.

Responses

CodeDescriptionReference
201

Successful response.

ChunkedUploads
400

Error encountered.

errorDetails

SDK Method

Envelopes::createChunkedUpload

Definitions

chunkedUploadPart

An object that contains information about the chunked upload part.

sequencestring

The order of the part in the chunked upload.

sizestring

The size of the part in bytes.

We recommend that a chunked upload part is no larger than a few MB in size.

chunkedUploadRequest

This is the request object for uploading a chunked upload.

chunkedUploadIdstring

The id of the chunked upload.

Note: This property is ignored in requests, and overridden with an auto-generated value in responses.

datastring

A Base64-encoded representation of the content hat is used to upload the file.

Maximum size: 50 MB. However, data is also subject to REST API limits regarding request sizes, and Internet Information Systems (IIS) might place further constraints on file size.

errorDetails

This object describes errors that occur. It is only valid for responses and ignored in requests.

errorCodestring

The code associated with the error condition.

messagestring

A brief message describing the error condition.

ChunkedUploads

The ChunkedUploads resource provides methods to complete integrity checks, and to add, commit, retrieve, initiate and delete chunked uploads.

checksumstring

A 64-byte, Secure Hash Algorithm 256 (SHA256) checksum that the caller computes across the entirety of the original content that has been uploaded to the chunked upload. DocuSign compares this value to its own computation. If the two values are not equal, the original content and received content are not the same and the commit action is refused.

chunkedUploadIdstring

The id of the chunked upload.

chunkedUploadParts[chunkedUploadPart]

A list of the parts that compose the chunked upload, including their byte sizes. The list must be contiguous before you can commit the chunked upload.

chunkedUploadUristring

The URI that you use to reference the chunked upload in other API requests, such as envelope document and envelope attachment requests.

committedstring

When true, the chunked upload has been committed. A committed chunked upload can no longer receive any additional parts and is ready for use within other API requests.

expirationDateTimestring

The UTC time at which the chunked upload expires and is no longer addressable.

Note: The length of time before expiration is configurable, and begins when you initiate the chunked upload. You must fully upload and use a chunked upload within this time. The default value for this duration is 20 minutes.

maxChunkedUploadPartsstring

The maximum number of parts allowed for a chunked upload. This value is configurable per DocuSign environment, account, or integrator. The default value is 128. The maximum possible value is 256.

maxTotalSizestring

The maximum total size allowed for a chunked upload. This value is configured per DocuSign environment, account, or integrator. The default value is 50 MB.

totalSizestring

The total size of the parts of the chunked upload.

Note: When a chunked upload is used as an envelope document, it is subject to the PDF size limit (25 MB) and page count limit that apply to all envelope documents.

Examples

Generic JSON Request/Response

Request
{
  "chunkedUploadId": "sample string 1",
  "data": "sample string 2"
}
Response
{
  "chunkedUploadId": "sample string 1",
  "chunkedUploadUri": "sample string 2",
  "expirationDateTime": "sample string 3",
  "checksum": "sample string 4",
  "committed": "sample string 5",
  "chunkedUploadParts": [
    {
      "sequence": "sample string 1",
      "size": "sample string 2"
    }
  ],
  "totalSize": "sample string 6",
  "maxChunkedUploadParts": "sample string 7",
  "maxTotalSize": "sample string 8"
}
Generic XML Request/Response

Request
<chunkedUploadRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <chunkedUploadId>sample string 1</chunkedUploadId>
  <data>sample string 2</data>
</chunkedUploadRequest> 
Response
<chunkedUploadResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <checksum>sample string 4</checksum>
  <chunkedUploadId>sample string 1</chunkedUploadId>
  <chunkedUploadParts>
    <chunkedUploadPart>
      <sequence>sample string 1</sequence>
      <size>sample string 2</size>
    </chunkedUploadPart>
  </chunkedUploadParts>
  <chunkedUploadUri>sample string 2</chunkedUploadUri>
  <committed>sample string 5</committed>
  <expirationDateTime>sample string 3</expirationDateTime>
  <maxChunkedUploadParts>sample string 7</maxChunkedUploadParts>
  <maxTotalSize>sample string 8</maxTotalSize>
  <totalSize>sample string 6</totalSize>
</chunkedUploadResponse> 
}} />