Skip to navigation

WorkspaceItems Resource

View as Markdown

This is the legacy eSignature Workspaces feature. To use the newest Workspaces product, please check our Workspaces API.

The WorkspaceItems resource provides methods that enable you to manage workspace items.

Methods supported

MethodDescription
createFIlePOST /restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files
Creates a workspace file.
deleteFolderItemsDEL /restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}
Deletes files or sub-folders from a workspace.
getFileGET /restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files/{fileId}
Gets a workspace file
listFilePagesGET /restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files/{fileId}/pages
List File Pages
listFolderItemsGET /restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}
List workspace folder contents
updateFilePUT /restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files/{fileId}
Update workspace file or folder metadata

WorkspaceItems properties

PropertyTypeDescription
callerAuthorizationworkspaceUserAuthorizationAn object that describes the caller’s workspace permissions.
contentTypestringIf the item is a file, this property specifies the content type of the file.
createdstringThe UTC DateTime when the workspace item was created.
createdByIdstringThe ID of the user who created the workspace item.
createdByInformationworkspaceUserDetails about the user who created the workspace item.
extensionstringThe file extension of a file item.
fileSizestringThe size of the file in bytes.
fileUristringThe URI for retrieving the file.
idstringThe ID of the workspace item.
isPublicstringWhen true, the item is public.
lastModifiedstringThe UTC DateTime that the item was last modified.
lastModifiedByIdstringThe ID of the user who last modified the item.
lastModifiedByInformationworkspaceUserDetails about the user who last modified the workspace item.
namestringThe name of the file or folder.
pageCountstringThe number of pages in a file.
parentFolderIdstringThe ID of the parent folder, or the special value root for the root folder.
parentFolderUristringThe URI of the parent folder.
sha256stringA 64-byte, Secure Hash Algorithm 256 (SHA256) checksum that the caller computes across the entirety of the original content of a file. Docusign compares this value to its own computation. If the two values are not equal, the original content and received content are not the same and the upload is refused.
thumbHeightstringThe height of the thumbnail image.
thumbnailpage
thumbWidthstringThe width of the thumbnail image.
typestringThe type of workspace item. Valid values are:
  • file
  • folder
uristringA URI containing the user ID.
userAuthorizationworkspaceUserAuthorizationAn object that describes the user’s workspace permissions.