List a Folder's (record) files (paginated)

get

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

Returns a paginated list of files within a given Drawer (sidedrawer) and Folder (record). Folders (record) that have been "soft-deleted" can be returned using the optional query parameter displayInactive. For files that require signatures, the parameter envelopeId keeps track of the added signatures and which document is the final version with all signatures.

Path Params

sidedrawerId

string

required

Drawer (sidedrawer) identifier.

recordId

string

required

Unique Folder (record) identifier (if Item type is record).

Query Params

limit

string

Limit of number of returned objects per page. Default is 20.

startingAfter

string

An object ID that defines a list object's position in the list by identifying the list object(s) appearing before it.

endingBefore

string

An object ID that defines a list object's position in the list by identifying the list object(s) appearing after it.

displayInactive

string

Set displayInactive = "true" to return inactive ("soft deleted") files.

correlationId

string

A correlationId is a unique parameter specifying the upload details of a file. This is used to "group" files uploaded as part of the same process.

fileTypeEnum

string

enum

Determines what kind of file is being pushed.

Allowed:

envelopeId

string

An envelopeId is used to identify signatures added to a document. This allows for the changes/signatures to be tracked and the completed (or most complete) document to be identified.

fileName

string

This is the unique name that the binary will have at 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.

uploadTitle

string

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

externalKey

string

External key.

externalKeyValue

string

External key value.

Response

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successfully retrieved files.