--- title: "Deletes files or sub-folders from a workspace." method: DELETE path: "/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}" tags: ["WorkspaceItems"] --- # Deletes files or sub-folders from a workspace. `DELETE /v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}` ## Request - Base URL: `https://www.docusign.net/restapi` - URL: `https://www.docusign.net/restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}` - Auth: none declared This method deletes one or more files or sub-folders from a workspace folder or root. Note: To delete items from a workspace, the `status` of the workspace must be `active`. ## Path parameters - `accountId` string, required - `folderId` string, required - `workspaceId` string, required ## Request body - WorkspaceItemList: An array of objects that describe the items in a workspace. - `items` WorkspaceItem[]: A list of workspace items. - `callerAuthorization` WorkspaceUserAuthorization: Provides properties that describe user authorization to a workspace. - `canDelete` string: When **true,** the workspace user can delete items from the workspace. - `canMove` string: When **true,** the workspace user can move the items in the workspace. - `canTransact` string: When **true,** the workspace user can create transactions from the workspace. - `canView` string: When **true,** the workspace user can view the items in the workspace. - `created` string: The UTC DateTime when the workspace user authorization was created. - `createdById` string: The ID of the user who created the workspace user authorization. - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string: The code associated with the error condition. - `message` string: A brief message describing the error condition. - `modified` string: The UTC DateTime when the workspace user authorization was last modified. - `modifiedById` string: The ID of the user who last modified the workspace user authorization. - `workspaceUserId` string: The ID of the workspace user. - `workspaceUserInformation` WorkspaceUser: This object represents the workspace user. This property is only returned in response to user specific GET call. - `accountId` string: The account ID associated with the workspace user. - `accountName` string: The name of the account that the workspace user belongs to. - `activeSince` string: The UTC DateTime when the user joined the workspace. - `created` string: The UTC DateTime when the workspace user was created. - `createdById` string: The ID of the user who created this workspace user. - `email` string: The workspace user's email address. - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string: The code associated with the error condition. - `message` string: A brief message describing the error condition. - `invitationEmailBlurb` string: The text of the workspace invitation email message sent to the user. - `invitationEmailSubject` string: The subject line of the workspace invitation email message sent to the user. - `lastModified` string: The UTC DateTime that the workspace user was last modified. - `lastModifiedById` string: The ID of the user who last modified the workspace user. - `status` string: Filters the results by user status. You can specify a comma-separated list of the following statuses: * ActivationRequired * ActivationSent * Active * Closed * Disabled - `type` string: Type of the user. Valid values: type_owner, type_participant. - `userId` string: The ID of the workspace user. - `userName` string: The name of workspace user. - `workspaceId` string: The ID of the workspace. - `workspaceUserBaseUrl` string: The URL for accessing the workspace user. - `workspaceUserId` string: The ID of the workspace user. - `workspaceUserUri` string: The URI for accessing the workspace user. - `contentType` string: If the item is a file, this property specifies the content type of the file. - `created` string: The UTC DateTime when the workspace item was created. - `createdById` string: The ID of the user who created the workspace item. - `createdByInformation` WorkspaceUser: This object represents the workspace user. This property is only returned in response to user specific GET call. - `accountId` string: The account ID associated with the workspace user. - `accountName` string: The name of the account that the workspace user belongs to. - `activeSince` string: The UTC DateTime when the user joined the workspace. - `created` string: The UTC DateTime when the workspace user was created. - `createdById` string: The ID of the user who created this workspace user. - `email` string: The workspace user's email address. - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string: The code associated with the error condition. - `message` string: A brief message describing the error condition. - `invitationEmailBlurb` string: The text of the workspace invitation email message sent to the user. - `invitationEmailSubject` string: The subject line of the workspace invitation email message sent to the user. - `lastModified` string: The UTC DateTime that the workspace user was last modified. - `lastModifiedById` string: The ID of the user who last modified the workspace user. - `status` string: Filters the results by user status. You can specify a comma-separated list of the following statuses: * ActivationRequired * ActivationSent * Active * Closed * Disabled - `type` string: Type of the user. Valid values: type_owner, type_participant. - `userId` string: The ID of the workspace user. - `userName` string: The name of workspace user. - `workspaceId` string: The ID of the workspace. - `workspaceUserBaseUrl` string: The URL for accessing the workspace user. - `workspaceUserId` string: The ID of the workspace user. - `workspaceUserUri` string: The URI for accessing the workspace user. - `extension` string: The file extension of a file item. - `fileSize` string: The size of the file in bytes. - `fileUri` string: The URI for retrieving the file. - `id` string: A unique ID for the Salesforce object. - `isPublic` string: When **true,** the item is public. - `lastModified` string: The UTC date and time that the comment was last updated. **Note:** This can only be done by the creator. - `lastModifiedById` string: The ID of the user who last modified the item. - `lastModifiedByInformation` WorkspaceUser: This object represents the workspace user. This property is only returned in response to user specific GET call. - `accountId` string: The account ID associated with the workspace user. - `accountName` string: The name of the account that the workspace user belongs to. - `activeSince` string: The UTC DateTime when the user joined the workspace. - `created` string: The UTC DateTime when the workspace user was created. - `createdById` string: The ID of the user who created this workspace user. - `email` string: The workspace user's email address. - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string: The code associated with the error condition. - `message` string: A brief message describing the error condition. - `invitationEmailBlurb` string: The text of the workspace invitation email message sent to the user. - `invitationEmailSubject` string: The subject line of the workspace invitation email message sent to the user. - `lastModified` string: The UTC DateTime that the workspace user was last modified. - `lastModifiedById` string: The ID of the user who last modified the workspace user. - `status` string: Filters the results by user status. You can specify a comma-separated list of the following statuses: * ActivationRequired * ActivationSent * Active * Closed * Disabled - `type` string: Type of the user. Valid values: type_owner, type_participant. - `userId` string: The ID of the workspace user. - `userName` string: The name of workspace user. - `workspaceId` string: The ID of the workspace. - `workspaceUserBaseUrl` string: The URL for accessing the workspace user. - `workspaceUserId` string: The ID of the workspace user. - `workspaceUserUri` string: The URI for accessing the workspace user. - `name` string: The name of the file or folder. - `pageCount` string: The number of pages in a file. - `parentFolderId` string: The ID of the parent folder, or the special value `root` for the root folder. - `parentFolderUri` string: The URI of the parent folder. - `sha256` string: A 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. - `thumbHeight` string: The height of the thumbnail image. - `thumbnail` Page: Description of a page of a document. - `dpi` string: The number of dots per inch used for the page image. - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string: The code associated with the error condition. - `message` string: A brief message describing the error condition. - `height` string: The height of the page in pixels. Must be an integer. - `imageBytes` string: The number of image bytes. - `mimeType` string: The MIME type. - `pageId` string: The ID of the page. - `sequence` string: The sequence of the page in the document, or page number. - `width` string: The width of the page in pixels. Must be an integer. - `thumbWidth` string: The width of the thumbnail image. - `type` string: The type of the workspace item. Valid values are file, folder. - `uri` string: A URI containing the user ID. - `userAuthorization` WorkspaceUserAuthorization: Provides properties that describe user authorization to a workspace. - `canDelete` string: When **true,** the workspace user can delete items from the workspace. - `canMove` string: When **true,** the workspace user can move the items in the workspace. - `canTransact` string: When **true,** the workspace user can create transactions from the workspace. - `canView` string: When **true,** the workspace user can view the items in the workspace. - `created` string: The UTC DateTime when the workspace user authorization was created. - `createdById` string: The ID of the user who created the workspace user authorization. - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string: The code associated with the error condition. - `message` string: A brief message describing the error condition. - `modified` string: The UTC DateTime when the workspace user authorization was last modified. - `modifiedById` string: The ID of the user who last modified the workspace user authorization. - `workspaceUserId` string: The ID of the workspace user. - `workspaceUserInformation` WorkspaceUser: This object represents the workspace user. This property is only returned in response to user specific GET call. - `accountId` string: The account ID associated with the workspace user. - `accountName` string: The name of the account that the workspace user belongs to. - `activeSince` string: The UTC DateTime when the user joined the workspace. - `created` string: The UTC DateTime when the workspace user was created. - `createdById` string: The ID of the user who created this workspace user. - `email` string: The workspace user's email address. - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests. - `errorCode` string: The code associated with the error condition. - `message` string: A brief message describing the error condition. - `invitationEmailBlurb` string: The text of the workspace invitation email message sent to the user. - `invitationEmailSubject` string: The subject line of the workspace invitation email message sent to the user. - `lastModified` string: The UTC DateTime that the workspace user was last modified. - `lastModifiedById` string: The ID of the user who last modified the workspace user. - `status` string: Filters the results by user status. You can specify a comma-separated list of the following statuses: * ActivationRequired * ActivationSent * Active * Closed * Disabled - `type` string: Type of the user. Valid values: type_owner, type_participant. - `userId` string: The ID of the workspace user. - `userName` string: The name of workspace user. - `workspaceId` string: The ID of the workspace. - `workspaceUserBaseUrl` string: The URL for accessing the workspace user. - `workspaceUserId` string: The ID of the workspace user. - `workspaceUserUri` string: The URI for accessing the workspace user. ## Response `200` Successful response. ## Other responses - `400`: Error encountered. --- [API](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api.md) - [All operations](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/revisions/77f1998c313d?raw)