Last updated

Migrate from using the Sheets folder

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

NOTE: See the changelog entry 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 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 to move folders to the workspace.
  3. Use POST /sheets/{sheetId}/move to move sheets to the workspace.
  4. Use POST /sights/{sightId}/move to move dashboards (aka, sights) to the workspace.

Migrate from GET /home

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

Here are steps for migrating from the GET /home method to using Workspaces.

  1. As described in the first section above, move all items and folders from the user's "Sheets" folder to a Workspace.

  2. Use the following methods to fetch items from Workspaces:

Migrate from GET /home/folders

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

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

  1. As described in the first section above, move all items and folders from the user's "Sheets" folder to a Workspace.

  2. Use the following methods to fetch items from the Workspace:

Migrate from GET /folders/personal

The GET /folders/personal method is deprecated and will be removed. The method lists the items and folders accessible to the user--these are items and folders the user owns or has been shared to.

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

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 and folders from the user's "Sheets" folder to a Workspace.

  2. Use POST /workspaces/{workspaceId}/sheets 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 and folders from the user's "Sheets" folder to a Workspace.

  2. Use POST /workspaces/{workspaceId}/folders 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 and folders from the user's "Sheets" folder to a Workspace.

  2. Use POST /workspaces/{workspaceId}/sheets/import to import a sheet in the desired workspace.