Changelog
Here is the log of changes to the API.
2025-04-01
IMPROVEMENT:
Regarding user reactivation, you can now reactivate a user to your plan if the user has been deactivated less than 30 days. The previous threshold was 7 days.
2025-03-25
DEPRECATION:
We deprecated the "Sheets" folder and are replacing it with Workspaces for a more streamlined experience.
We're providing access to the following API endpoints associated with the "Sheets" folder until June.
As part of this deprecation, we deprecated the home
destinationType
enum in folder and sheets endpoints.
Learn how to update your code to these changes at Migrate from using the Sheets folder.
2025-03-14
FIX:
We updated the Event
schema documentation to provide more accurate examples and comprehensive information:
- Updated the
eventId
example to match the actual format used in production - Expanded the
objectType
enum to include all possible resource types - Fixed the property name from
eventTimeStamp
toeventTimestamp
- Updated the
source
field description and added the complete list of possible values
2025-03-11
FIX:
We fixed the Criteria
schema's operator
property to include the enum value IS_ONE_OF
. The value has been part of the schema implementation and is listed in the example but missing from the property documentation.
2025-03-07
FIX:
We fixed the Assume-User
header description. The header allows System Administrators (admins) to impersonate or act on behalf of any user (including other admins) in their plan to make API calls. For details, see User Impersonation.
2025-03-04
ADDITION:
We added the POST filteredEvents endpoint. This endpoint allows non-admin users to retrieve events for sheets and workspaces that they have access to.
2025-03-03
DEPRECATION REVERT:
We reverted deprecation notices for the following endpoint methods:
See 2025-02-01 for the original change.
ADDITION REVERT:
We removed the 'lastKey' query parameter from the GET /workspaces
endpoint method.
See 2025-02-18 for the original change.
2025-02-18
ADDITION:
We added the lastKey
query parameter and response property for the GET /workspaces
endpoint method. This is the new and recommended way to get paginated workspace results. The pageSize
query parameter is used in conjunction with lastKey
--the page
and includeAll
query parameters remain deprecated and will be removed.
2025-02-12
REMOVAL:
We removed the permalink
option from the include
query parameter for the following endpoint methods because the option has never been supported:
2025-02-10
FIX:
We corrected response schemas for the following endpoint methods:
2025-02-03
DEPRECATION:
We deprecated the distributionLink
and sheetVersion
options for the include
query parameter on the following endpoint methods:
The corresponding response properties will soon stop providing meaningful values.
DEPRECATION:
We deprecated the loadAll
query parameter on the GET /folders/{folderId}
endpoint method, and we will eventually remove it. To replace the loadAll
query parameter, use calls to GET /folders/{folderId}
to build out workspace structures.
FIX:
Regarding the ownerInfo
option for the include
query parameter, we clarified which user is returned when no user is an Owner of the asset.
2025-02-01
DEPRECATION:
We deprecated the includeAll
and page
params for the following endpoint methods:
We deprecated the following response properties because they are irrelevant to the new pagination system.
pageNumber
totalCount
totalPages
2025-01-22
IMPROVEMENT:
We now automatically deactivate Webhooks on sheets exceeding any scale limits.
Scale limits:
- 20,000 rows
- 400 columns
- 500,000 cells
Related resources:
- Webhook Status has a new related status
- Webhook Error Codes has new related error codes
To keep webhooks enabled on a sheet, stay below the limits mentioned above.
As a sheet Owner, you can re-enable webhooks on a sheet by following these steps:
- Reduce the sheet size to within the limits mentioned above.
- Execute the
PUT /webhooks/{webhookId}
method with theenabled
body attribute set totrue
.
Related resources:
- Webhook Status has a new related status.
- Webhook Error Codes has new related error codes.
2024-10-14
IMPROVEMENT:
For Smartsheet US and Smartsheet Regions Europe, we introduced a one-minute debounce to optimize event trigger handling in the Webhooks event callback API. It reduces traffic and prevents workflows from acting on incomplete or transitional data.
2024-10-09
FIX:
We updated the WebContentWidgetContent.type
enum, from WEBCONTENT
to WidgetWebContent
. The former enum WEBCONTENT
was incorrect.