# Migrate from using the Sheets folder

The "Sheets" folder has been deprecated since March 25, 2025. Workspaces replaces it.

> **Note:** See the [changelog entry](/api/smartsheet/changelog#2025-03-25) for details.


The following sections explain how to migrate from using the "Sheets" folder endpoints to using Workspaces.

## Move all items from the Sheets folder to a workspace

You can create a workspace and move "Sheets" folder items into it via the Smartsheet application UI or the Smartsheet API, as described by the following steps.

Use the following methods to move items and folders from the user's "Sheets" folder to a Workspace.

1. Use [`POST /workspaces`](/api/smartsheet/openapi/workspaces/create-workspace) to create a workspace for the "Sheets" folder items if you don't already have a workspace for them.
2. Use [`POST /folders/{folderId}/move`](/api/smartsheet/openapi/folders/move-folder) to move folders to the workspace.
3. Use [`POST /sheets/{sheetId}/move`](/api/smartsheet/openapi/sheets/move-sheet) to move sheets to the workspace.
4. Use [`POST /sights/{sightId}/move`](/api/smartsheet/openapi/dashboards/move-sight) to move dashboards (aka, sights) to the workspace.


## Migrate from `GET /home`

The `GET /home` method is deprecated and will be removed. This method currently returns the entire hierarchy of items within the user's "Sheets" folder.

To migrate from the `GET /home` method, follow these steps:

1. As described in the [relevant section above](#move-all-items-from-the-sheets-folder-to-a-workspace), first move all items and folders from the user's "Sheets" folder to a Workspace.
2. Call [`GET /workspaces/{workspaceId}/metadata`](/api/smartsheet/openapi/workspaces/get-workspace-metadata) to get the Workspace's metadata.
3. Call [`GET /workspaces/{workspaceId}/children`](/api/smartsheet/openapi/workspaces/get-workspace-children) to retrieve paginated metadata on the Workspace's child items.
4. Call [`GET /folder/{folderId}/children`](/api/smartsheet/openapi/folders/get-folder-children) to retrieve paginated metadata on the child items of the child folders in the Workspace.


To retrieve the full hierarchy, recursively call [`GET /folder/{folderId}/children`](/api/smartsheet/openapi/folders/get-folder-children) on child folders.

> **Note:** The `Get ... children` methods use [token-based pagination](/api/smartsheet/guides/basics/pagination#token-based-pagination).


## Migrate from `GET /home/folders`

The `GET /home/folders` method is deprecated and will be removed. This method currently lists the child folders of the user's "Sheets" folder.

To migrate from the `GET /home/folders` method, follow these steps:

1. As described in the [relevant section above](#move-all-items-from-the-sheets-folder-to-a-workspace), first move all items and folders from the user's "Sheets" folder to a Workspace.
2. Call [`GET /workspaces/{workspaceId}/children?childrenResourceTypes=folders`](/api/smartsheet/openapi/workspaces/get-workspace-children) to retrieve paginated folder type metadata on the Workspace's folders.


> **Note:** The `GET \*children` methods use [token-based pagination](/api/smartsheet/guides/basics/pagination#token-based-pagination).


## Migrate from `GET /folders/personal`

The `GET /folders/personal` method is deprecated and will be removed. This method currently lists all items and folders accessible to the user (i.e., items and folders the user owns or has been shared to).

### Listing Accessible Items

Use the following methods in place of calling the `GET /folders/personal` method to list accessible items:

* [`GET /reports`](/api/smartsheet/openapi/reports/getreports) lists reports accessible to the user.
* [`GET /sheets`](/api/smartsheet/openapi/sheets/list-sheets) lists sheets accessible to the user.
* [`GET /sights`](/api/smartsheet/openapi/dashboards/list-sights) lists dashboards accessible to the user.
* [`GET /templates`](/api/smartsheet/openapi/templates/templates-list) lists user-created templates accessible to the user.
* [`GET /templates/public`](/api/smartsheet/openapi/templates/templates-listpublic) lists public templates accessible to the user.


### Listing Accessible Folders

Use the following methods in place of calling the `GET /folders/personal` method to list accessible folders:

* [`GET /workspaces`](/api/smartsheet/openapi/workspaces/list-workspaces) lists Workspaces accessible to the user.
* [`GET /workspaces/{workspaceId}/children?childrenResourceTypes=folders`](/api/smartsheet/openapi/workspaces/get-workspace-children) retrieves paginated folder type metadata for the child folders of the matching Workspace.
* [`GET /folders/{folderId}/children?childrenResourceTypes=folders`](/api/smartsheet/openapi/folders/get-folder-children) retrieves paginated folder type metadata for the child folders of the matching folder.


> **Note:** The `GET */children` methods use [token-based pagination](/api/smartsheet/guides/basics/pagination#token-based-pagination).


## Migrate from POST /sheets

Here are steps for migrating from the `POST /sheets` method to using Workspaces.

1. As described in the [first section above](#move-all-items-from-the-sheets-folder-to-a-workspace), move all items and folders from the user's "Sheets" folder to a Workspace.
2. Use [`POST /workspaces/{workspaceId}/sheets`](/api/smartsheet/openapi/sheets/create-sheet-in-workspace) to create a sheet in the desired workspace.


## Migrate from POST /home/folders

Here are steps for migrating from the `POST /home/folders` method to using Workspaces.

1. As described in the [first section above](#move-all-items-from-the-sheets-folder-to-a-workspace), move all items and folders from the user's "Sheets" folder to a Workspace.
2. Use [`POST /workspaces/{workspaceId}/folders`](/api/smartsheet/openapi/workspaces/create-workspace-folder) to create a folder in the desired workspace.


## Migrate from POST /sheets/import

Here are steps for migrating from the `POST /sheets/import` method to using Workspaces.

1. As described in the [first section above](#move-all-items-from-the-sheets-folder-to-a-workspace), move all items and folders from the user's "Sheets" folder to a Workspace.
2. Use [`POST /workspaces/{workspaceId}/sheets/import`](/api/smartsheet/openapi/imports/import-sheet-into-workspace) to import a sheet in the desired workspace.