> 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

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

## Methods supported

| Method                                                                                             | Description                                                                                                                                                            |
| -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [createFIle](/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/createfile)               | POST `/restapi/v2/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files` Creates a workspace file.                                                    |
| [deleteFolderItems](/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/deletefolderitems) | DEL `/restapi/v2/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}` Deletes workspace one or more specific files/folders from the given folder or root. |
| [getFile](/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/getfile)                     | GET `/restapi/v2/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files/{fileId}` Get Workspace File                                                   |
| [listFilePages](/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/listfilepages)         | GET `/restapi/v2/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files/{fileId}/pages` List File Pages                                                |
| [listFolderItems](/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/listfolderitems)     | GET `/restapi/v2/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}` List Workspace Folder Contents                                                      |
| [updateFile](/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/updatefile)               | PUT `/restapi/v2/accounts/{accountId}/workspaces/{workspaceId}/folders/{folderId}/files/{fileId}` Update Workspace File Metadata                                       |

## WorkspaceItems properties

| Property                    | Type                       | Description                                                                                                          |
| --------------------------- | -------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `callerAuthorization`       | workspaceUserAuthorization |                                                                                                                      |
| `contentType`               | string                     |                                                                                                                      |
| `created`                   | string                     | The UTC DateTime when the workspace item was created.                                                                |
| `createdById`               | string                     |                                                                                                                      |
| `createdByInformation`      | workspaceUser              | Details about the user who created the workspace item.                                                               |
| `extension`                 | string                     |                                                                                                                      |
| `fileSize`                  | string                     |                                                                                                                      |
| `fileUri`                   | string                     |                                                                                                                      |
| `id`                        | string                     |                                                                                                                      |
| `isPublic`                  | string                     | If true, this supersedes need for bit mask permission with workspaceUserAuthorization                                |
| `lastModified`              | string                     |                                                                                                                      |
| `lastModifiedById`          | string                     | Utc date and time the comment was last updated (can only be done by creator)                                         |
| `lastModifiedByInformation` | workspaceUser              | Details about the user who last modified the workspace item.                                                         |
| `name`                      | string                     | A simple string description of the item, such as a file name or a folder name.                                       |
| `pageCount`                 | string                     |                                                                                                                      |
| `parentFolderId`            | string                     | The ID of the parent folder. This is the GUID of the parent folder, or the special value 'root' for the root folder. |
| `parentFolderUri`           | string                     |                                                                                                                      |
| `type`                      | string                     | The type of the workspace item. Valid values are file, folder.                                                       |
| `uri`                       | string                     |                                                                                                                      |


## API Docs

- WorkspaceItems [Create workspace file](https://developers.docusign.com/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/createfile.md)
- WorkspaceItems [Delete files or sub-folders from workspace](https://developers.docusign.com/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/deletefolderitems.md)
- WorkspaceItems [Get workspace file](https://developers.docusign.com/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/getfile.md)
- WorkspaceItems [List file pages](https://developers.docusign.com/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/listfilepages.md)
- WorkspaceItems [List workspace folder contents](https://developers.docusign.com/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/listfolderitems.md)
- WorkspaceItems [Update workspace file or folder metadata](https://developers.docusign.com/docs/esign-rest-api/v2/reference/workspaces/workspaceitems/updatefile.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://developers.docusign.com/openapi.json)
- [OpenAPI YAML](https://developers.docusign.com/openapi.yaml)