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.
- Use
POST /workspaces
to create a workspace for the "Sheets" folder items if you don't already have a workspace for them. - Use
POST /folders/{folderId}/move
to move folders to the workspace. - Use
POST /sheets/{sheetId}/move
to move sheets to the workspace. - 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.
As described in the first section above, move all items and folders from the user's "Sheets" folder to a Workspace.
Use the following methods to fetch items from Workspaces:
GET /workspaces
lists the user's Workspaces.GET/workspaces/{workspaceId}
fetches the Workspace's children.
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.
As described in the first section above, move all items and folders from the user's "Sheets" folder to a Workspace.
Use the following methods to fetch items from the Workspace:
GET /workspaces
lists the user's Workspaces.GET/workspaces/{workspaceId}
fetches the Workspace's children.GET /folders/{folderId}
fetches the folder's children.
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:
GET /folders
lists the folders accessible to the user.GET /folders/{folderId}
fetches the folder's children.GET /sights
lists the dashboards accessible to the user.GET /reports
lists the reports accessible to the user.GET /sheets
lists the sheets accessible to the user.GET /templates
lists the user-created templates accessible to the user.GET /templates/public
lists the public templates accessible to the user.
Migrate from POST /sheets
Here are steps for migrating from the POST /sheets
method to using Workspaces.
As described in the first section above, move all items and folders from the user's "Sheets" folder to a Workspace.
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.
As described in the first section above, move all items and folders from the user's "Sheets" folder to a Workspace.
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.
As described in the first section above, move all items and folders from the user's "Sheets" folder to a Workspace.
Use
POST /workspaces/{workspaceId}/sheets/import
to import a sheet in the desired workspace.