GET getRecordFolderContents

Method Description	This method gets all files and folders inside a specific record folder. It can also retrieve files and folders from the first level of sub-folders.
Returns	DirectoryItem[]
Limitations	TBD
Usage	For notes on how to authenticate see NetSuite documentation. General usage notes see: File Sync REST API
Since	FileSync 0.6.0

Request Parameters

Parameter	Type	Required	Description	Since
`options.action`	string	required	Static value that has to equal getRecordFolderContents	0.6.0
`options.script`	string	required	Static value that has to equal customscript_b4cd_fileapi_rl	0.6.0
`options.deploy`	string	required	Static value that has to equal customdeploy_b4cd_fileapi_rl	0.6.0
`options.recordTypeConfigId`	integer	required	Internal ID of the FileSync Record Type Configuration record (customrecord_b4cd_record_type_config).	0.6.0
`options.recordId`	integer	required	The internal ID of the record in NetSuite which we are finding associated files for.	0.6.0
`options.includeSubfolders`	boolean	optional	Set the value to true to include sub-folder contents in the result. Default value: false Limitations: each sub-folder included will require another HTTP request to the file hosting platform and will thus count toward the NetSuite governance limits. It is not recommended to use this option on folders with a large number of child records.	0.6.0

Returns: DirectoryItem

Property	Type	Description	Since
`DirectoryItem.name`	string	The file or folder name	0.6.0
`DirectoryItem.uniqueId`	string	The unique ID of the file or folder as assigned by the file hosting service.	0.6.0
`DirectoryItem.type`	string	Possible Values: "file", "folder"	0.6.0
`DirectoryItem.fileSize`	integer	File size in bytes.	0.6.0
`DirectoryItem.apiUri`	string	The URI used to access the file or folder via the API.	0.6.0
`DirectoryItem.filePath`	string	The relative file or folder path on the file hosting service starting from the base directory.	0.6.0
`DirectoryItem.uri`	string	The user-navigable URI for the folder or file on the file hosting platform. This can be used to construct hyperlinks for users to reach the file or folder externally.	0.6.0

Errors

Error Code	Details
`SSS_MISSING_REQD_ARGUMENT`	A required argument is missing or undefined.
`MULTPLE_CONFIGS_FOUND`	Multiple Record Type Configurations were found for the specified record type. Use the recordTypeConfigId parameter instead of the recordType parameter.

Request Query Parameters Example

{
    script: "customscript_b4cd_fileapi_rl",
    deploy: "customdeploy_b4cd_fileapi_rl",
    action: "getRecordFolderContents",
    recordTypConfigId: 3,
    recordId: 20703,
    includeSubFolders: true
}

Was this article helpful?