Upload documents to sign

post

https://api.ext-sandbox.fourthline.com/v1/onboarding/signatures/{workflowId}/documentsToSign

Use this endpoint for Qualified Electronic Signature workflows to upload the document(s) to sign.

Important Important:
• Before using this endpoint, see the integration guide.
• signatureId and workflowId are string identifiers that can be used interchangeably.
• Documents can be uploaded in parallel as long as each document uses a unique document_id.
• Requests around 26 MB may hit the default request size limit.
• For optimal reliability and experience, we recommend keeping the number of documents per signature low (typically two or three).
• A successful response is empty.

Path Params

workflowId

string

required

Our unique identifier for the workflow, returned in the Create workflow response.

Format: uuid string

Example: 790f325a-48c9-4b82-bb53-c0ea128236f0

Tip: Use this as the reference number for any questions.

Form Data

documentsToSign

array of objects

required

An array of form data objects, one for each uploaded document to sign.
Required headers:
Content-Disposition: form-data; name=documentsToSign
Content-Type: application/json

Tip: For each document, include an array in the documentsToSign object, or the file is ignored.

documentsToSign*

files

file

required

An array of form data files, one for each document to sign.
Required headers:
Content-Disposition: form-data; name=files; filename=filename.pdf (must match 1 filename in documentsToSign)
Content-Type: application/pdf

Responses

202Documents upload accepted

400Invalid request parameters

404Signature not found

409Conflict

422The request could not be processed