Skip to main content

Create a staged document upload handle

POST 
/v1/sign/uploads

Initializes a direct document upload handle for large agreements and templates.

Upload Flow​

  1. Call this endpoint with the document's contentType and optional sizeBytes to receive an uploadUrl and uploadId.
  2. Issue an HTTP PUT request directly to uploadUrl with the binary document payload and the returned headers. The signed URL expires after 15 minutes.
  3. Reference the returned uploadId as documentUploadId when creating an agreement (POST /v1/sign/agreements), uploading a document to an agreement (POST /v1/sign/agreements/{agreementId}/documents), or creating/importing a template (POST /v1/sign/templates / POST /v1/sign/templates/import). Staged uploads remain valid for 24 hours.

Request​

Responses​

Staged upload handle created successfully

Response Headers
    X-Request-Id

    Correlation id for this request, returned on every response (success and error). Quote it when contacting support to pinpoint the exact request, and use it to correlate your own logs. It is the same 128-bit id as the trace-id segment of the traceparent header.

    traceparent

    W3C Trace Context identifier for this request, returned on every response. Send your own traceparent on a request to have it adopted, so a multi-call workflow shares one trace. Format: 00-<32-hex trace-id>-<16-hex span-id>-<2-hex flags>.

    Cache-Control

    Directives to prevent caching of signed upload URLs