--- 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}` 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.net/docusign/apis/docusign-esignature-rest-api.md) · [All operations](https://skmtc.net/docusign/apis/docusign-esignature-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docusign/docusign-esignature-rest-api/versions/77f1998c313d/schema)