Create file(s)

post https://api-sbx.sidedrawersbx.com/api/v2/record-files/sidedrawer/sidedrawer-id/{sidedrawerId}/records/record-id/{recordId}/record-files

Adds one or more files in a Drawer (sidedrawer) and Folder (record) using the Drawer identifier (sidedrawerId) and Folder identifier (recordId). Supply the file in the request body. Specify the file name, upload title, file type, and file extension as query parameters. A checksum can be calculated using the SHA256 algorithm to guarantee integrity control using the checkSum parameter. Add multiple files by setting the boolean query parameter multipleFiles = true.

For documents that require signatures, the parameter envelopeId tracks the signatures added to the document and which document version has all required signatures.

ℹ️
Versions
This endpoint also has a v1 version. Understand the difference here.

Path Params

sidedrawerId

string

required

Unique Drawer (sidedrawer) identifier.

recordId

string

required

Unique Folder (record) identifier.

Query Params

fileName

string

This is the unique name that the binary will have in the SideDrawer Database. It has to be unique. This is mandatory, and it can be set by the App. In order to do so, add the timestamp when EACH file is posted (YYMMDDHHMMSS_*), all timestamps for each file will be different.

envelopeId

string

Used as an ID to connect/combine different files that will be part of a sequence of signatures. The objective is to have the envelopeId to track all signatures and which one is the latest one that combines them all.

correlationId

string

This is the details of the upload instance. It is not mandatory.

uploadTitle

string

This is what should be listed in the "File History" list.

displayType

string

The front-end application will interpret (or ignore, in older versions) this parameter and display the file on screen using different versions of PDFTron. Based on that, the PDFTron widget will present the end user the ability to insert a signature, text fields, annotations, comments, or just preview the contents.

fileType

string

Enum that determines what kind of file is being pushed.

fileExtension

string

Original extension of the file being uploaded.

checkSum

string

Optional checksum calculated with the SHA256 algorithm. This guarantees integrity control over the uploaded file.

multipleFiles

boolean

Set multipleFiles = true if you want to create multiple files.

Body Params

File to be uploaded.

file

required

File to be uploaded.

metadata

object

Metadata key-value pairs.

externalKeys

array of objects

External key-value pairs.

externalKeys

blocks

array

Blocks hashes.

blocks

recordFilesData

array of objects

If ?multipleFiles=true, input the files (recordFiles) data array.

recordFilesData

Response

`record`) has been successfully created.

xxxxxxxxxx
curl --request POST \
     --url https://api-sbx.sidedrawersbx.com/api/v2/record-files/sidedrawer/sidedrawer-id/sidedrawerId/records/record-id/recordId/record-files \
     --header 'accept: application/json' \
     --header 'content-type: multipart/form-data'

xxxxxxxxxx
 
{
  "id": "string",
  "fileName": "string",
  "correlationId": "string",
  "uploadDetail": "string",
  "caption": "string",
  "uploader": "string",
  "url": "string",
  "fileTypeEnum": "image"
}

ℹ️Versions

201The Folder (record) has been successfully created.

ℹ️
Versions

`record`) has been successfully created.