FIfirma
Signing Requests

Upload a document

Changed on

Request a presigned upload URL for a document. Upload the file directly to the returned URL, then pass the document_id when creating a signing request. Use this for documents larger than 5MB that exceed the inline base64 request size limit.

post/documents

Request

Request body

file_namestring required

Name of the document file

file_sizeinteger required

File size in bytes. Maximum 50MB (52,428,800 bytes).

content_type'application/pdf' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' required

MIME type of the document

Example request

{
  "file_name": "contract.pdf",
  "file_size": 15000000,
  "content_type": "application/pdf"
}

Response

Upload URL created

document_idstring uuid

Document ID to pass in the signing request

upload_urlstring uri

Presigned URL to PUT the document file to. Send the raw file bytes with Content-Type matching the requested content_type.

upload_tokenstring

Upload authentication token (included in the upload_url)

expires_ininteger

Seconds until the upload URL expires

Example response

{
  "expires_in": 3600
}

Changes