Create Multipart Upload Task

POST/

Creates a multipart upload task and returns a TaskId for subsequent part uploads.

Suitable for large file uploads by splitting the file into multiple parts. Each part is a fixed 16 MB, except the last part which can be smaller.

Request Parameters

Header Parameters

AuthorizationRequiredstring

Bearer <access_token>

X-TC-ActionRequiredstring

API action name, fixed value: `CreateUploadTask`

X-TC-TimestampRequiredstring

Current UNIX timestamp in seconds

X-TC-LanguageRequiredstring

Response language, required. Supported values: zh-CN / zh-TW / en-US / vi-VN / th-TH / ms-MY / id-ID

Request Body

multipart/form-data

BusinessTypestring

Business type. Supported values: - `TEMPLATE`: Template - `FLOW`: Contract - `SEAL`: Seal - `DOCUMENT`: Contract attachment - `USER`: User-related file - `TEMP`: Temporary file

TEMPLATEFLOWSEALDOCUMENTUSERTEMP

FileNamestring

File name, e.g. `test.pdf`. File name length limit is 100 characters

Response Parameters

Response.Data

ResponseOptionalobject

⌃Sub-properties

RequestIdOptionalstring

Request ID for tracking and debugging

ErrorOptionalobject

Error information (null on success)

⌃Sub-properties

CodeOptionalstring

Error code. Common codes: `INVALID_REQUEST` / `UNAUTHORIZED` / `FORBIDDEN` / `NOT_FOUND` / `INTERNAL_ERROR`. Endpoints may also return business-specific codes such as `VALIDATION.*`, `ENVELOPE.*`, `SIGNING.*`, `OPENAPI.*`. See individual endpoint documentation for details

MessageOptionalstring

Error description

TaskIdOptionalstring

Multipart upload task ID to be passed to the upload part endpoint. TaskId is valid for 24 hours

Response Example

{
  "Response": {
    "RequestId": "a6c43ab5-895d-4eb8-98b8-c64edb4e3331",
    "TaskId": "yD3J7UUckpeq3q6cUIGGOhSK1cZXTfsQ"
  }
}

Upload File Upload File Part