WorkspaceItems: deleteFolderItems

Request

HTTP request

DELETE /v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}

Parameters

Parameter NameValueDescription
Path Parameters
accountIdstring

The external account number (int) or account ID GUID.

folderIdstring

Unique identifier for the folder.

workspaceIdstring

Specifies the workspace ID GUID.

Request Body

workspaceItemList

Responses

CodeDescriptionReference
200

Successful response.

400

Error encountered.

errorDetails

SDK Method

Workspaces::deleteWorkspaceFolderItems

Definitions

errorDetails

This object describes errors that occur. It is only valid for responses, and ignored in requests.

errorCodestring

A code associated with the error condition.

messagestring

A brief message describing the error condition.

page

Description of a page of a document.

dpistring

The number of dots per inch used for the page image.

errorDetailserrorDetails

If an error occurs, this property describes the error.

heightstring

The height of the page in pixels.

imageBytesstring

The number of image bytes.

mimeTypestring

The MIME type.

pageIdstring

The unique ID of the page.

sequencestring

The sequence of the page in the document, or page number.

widthstring

The width of the page in pixels.

workspaceItemList

Provides properties that describe the items contained in a workspace.

items[WorkspaceItems]

workspaceUser

A workspaceUser representing the user. This property is only returned in response to user specific GET call.

accountIdstring

The account ID associated with the envelope.

accountNamestring

The name of the account associated with the current workspace user.

activeSincestring

createdstring

The UTC DateTime when the workspace user was created.

createdByIdstring

emailstring

Filters returned user records by the specified email address.

errorDetailserrorDetails

Object that describes errors that occur. Only valid for responses; ignored in requests.

invitationEmailBlurbstring

invitationEmailSubjectstring

lastModifiedstring

Utc date and time the comment was last updated (can only be done by creator.)

lastModifiedByIdstring

statusstring

Filters the results by user status. You can specify a comma-separated list of the following statuses:

  • ActivationRequired
  • ActivationSent
  • Active
  • Closed
  • Disabled

typestring

Type of user:

  • type_owner
  • type_participant

userIdstring

The user ID of the user being accessed. Generally this is the user ID of the authenticated user, but if the authenticated user is an Administrator on the account, this can be another user the Admin user is accessing. Note: For Envelopes:listStatusChanges (GET /v2.1/accounts/{accountId}/envelopes), the user_id query parameter is not implemented and should not be used.

userNamestring

The name of the user.

workspaceIdstring

Specifies the workspace ID GUID.

workspaceUserBaseUrlstring

The relative URI that may be used to access a workspace user.

workspaceUserIdstring

workspaceUserUristring

workspaceUserAuthorization

Provides properties that describe user authorization to a workspace.

canDeletestring

canMovestring

canTransactstring

canViewstring

createdstring

The UTC DateTime when the workspace user authorization was created.

createdByIdstring

errorDetailserrorDetails

Object that describes errors that occur. Only valid for responses; ignored in requests.

modifiedstring

modifiedByIdstring

workspaceUserIdstring

workspaceUserInformationworkspaceUser

WorkspaceItems

callerAuthorizationworkspaceUserAuthorization

contentTypestring

createdstring

The UTC DateTime when the workspace item was created.

createdByIdstring

createdByInformationworkspaceUser

extensionstring

fileSizestring

fileUristring

idstring

A unique ID for the Salesforce object.

isPublicstring

If true, this supersedes need for bit mask permission with workspaceUserAuthorization

lastModifiedstring

Utc date and time the comment was last updated (can only be done by creator.)

lastModifiedByIdstring

Utc date and time the comment was last updated (can only be done by creator)

lastModifiedByInformationworkspaceUser

namestring

A simple string description of the item, such as a file name or a folder name.

pageCountstring

An integer value specifying the number of document pages in the template.

parentFolderIdstring

The ID of the parent folder. This is the GUID of the parent folder, or the special value 'root' for the root folder.

parentFolderUristring

sha256string

thumbHeightstring

thumbnailpage

thumbWidthstring

typestring

The type of the workspace item. Valid values are file, folder.

uristring

URI containing the user ID.

userAuthorizationworkspaceUserAuthorization

Examples

Generic JSON Request

Request
{
  "items": [
    {
      "id": "sample string 1",
      "name": "sample string 2",
      "type": "sample string 3",
      "uri": "sample string 4",
      "isPublic": "sample string 5"
    }
  ]
}
Generic XML Request

Request
<workspaceItemList xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <items>
    <workspaceItem>
      <id>sample string 1</id>
      <isPublic>sample string 5</isPublic>
      <name>sample string 2</name>
      <type>sample string 3</type>
      <uri>sample string 4</uri>
    </workspaceItem>
  </items>
</workspaceItemList> 
}} />