> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# WorkspaceItems Resource

> **Note**
>
> This is the legacy eSignature Workspaces feature. To use the newest Workspaces product, please check our [Workspaces API](/docs/workspaces-api).

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

## Methods supported

| Method                                                                                          | Description                                                                                                                                  |
| ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [createFIle](/docs/esign-rest-api/reference/workspaces/workspaceitems/createfile)               | POST `/restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files` Creates a workspace file.                        |
| [deleteFolderItems](/docs/esign-rest-api/reference/workspaces/workspaceitems/deletefolderitems) | DEL `/restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}` Deletes files or sub-folders from a workspace.          |
| [getFile](/docs/esign-rest-api/reference/workspaces/workspaceitems/getfile)                     | GET `/restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files/{fileId}` Gets a workspace file                    |
| [listFilePages](/docs/esign-rest-api/reference/workspaces/workspaceitems/listfilepages)         | GET `/restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files/{fileId}/pages` List File Pages                    |
| [listFolderItems](/docs/esign-rest-api/reference/workspaces/workspaceitems/listfolderitems)     | GET `/restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}` List workspace folder contents                          |
| [updateFile](/docs/esign-rest-api/reference/workspaces/workspaceitems/updatefile)               | PUT `/restapi/v2.1/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files/{fileId}` Update workspace file or folder metadata |

## WorkspaceItems properties

| Property                    | Type                       | Description                                                                                                                                                                                                                                                                                                        |
| --------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `callerAuthorization`       | workspaceUserAuthorization | An object that describes the caller's workspace permissions.                                                                                                                                                                                                                                                       |
| `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              | Details about the user who created the workspace item.                                                                                                                                                                                                                                                             |
| `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                     | The ID of the workspace item.                                                                                                                                                                                                                                                                                      |
| `isPublic`                  | string                     | When **true,** the item is public.                                                                                                                                                                                                                                                                                 |
| `lastModified`              | string                     | The UTC DateTime that the item was last modified.                                                                                                                                                                                                                                                                  |
| `lastModifiedById`          | string                     | The ID of the user who last modified the item.                                                                                                                                                                                                                                                                     |
| `lastModifiedByInformation` | workspaceUser              | Details about the user who last modified the workspace item.                                                                                                                                                                                                                                                       |
| `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                       |                                                                                                                                                                                                                                                                                                                    |
| `thumbWidth`                | string                     | The width of the thumbnail image.                                                                                                                                                                                                                                                                                  |
| `type`                      | string                     | The type of workspace item. Valid values are:- `file`
- `folder`                                                                                                                                                                                                                                                   |
| `uri`                       | string                     | A URI containing the user ID.                                                                                                                                                                                                                                                                                      |
| `userAuthorization`         | workspaceUserAuthorization | An object that describes the user's workspace permissions.                                                                                                                                                                                                                                                         |