Smartsheet（スマートシート）は2026年6月15日、進行中のAPIクリーンアップと移行作業の一環として、フォルダー、ワークスペース、ダッシュボード、テンプレート、共有、およびウェブフックにおける無制限の結果セット機能の提供を終了すると発表した。当初の廃止通知については、2025年8月4日の変更履歴エントリーが参照されている。
Smartsheetは、ウェブフックに関して、includeAllクエリーパラメーターが削除され、pageSizeの上限が10000に設定されたと発表した。レスポンスでは、正確な合計件数や合計ページ数は提供されなくなり、totalCountとtotalPagesは両方とも-1に設定される。また、ウェブフックリストは作成日順に、最新のものが最初に返される。includeAllを使っている開発者は、クライアントコードを更新して、pageSizeとpageパラメーターを使用したオフセットベースのページネーションを使うよう促された。pageSizeが10000より大きい場合は、10000以下に減らすようアドバイスされた。
ダッシュボード一覧表示（GET /sights）は、無制限のページベースの制御からトークンベースのページングに切り替わった。Smartsheetは、includeAll、modifiedSince、page、paginationType（非推奨期間中に使用されていた一時的なパラメーター）、pageSize、およびレスポンス内のいくつかのページングフィールド（pageNumber、pageSize、totalCount、totalPages）が削除されたと報告した。このサービスでは、maxItems（1ページ当たりのアイテム数）とlastKey（前のページのトークン）を使用したトークンベースのページネーションが必要となり、実装パターンに関するドキュメントとSDKの例が提供されている。
ワークスペースの一覧表示（GET /workspaces）も同様の変更が加えられた。includeAll、modifiedSince、page、および一時的なpaginationTypeフィールドが削除され、レスポンス内の従来のpageningフィールドも削除された。新しいトークンベースのアプローチを採用するための移行ガイダンスは、SDKの例を参照するよう指示されている。
ワークスペースの詳細を取得する処理は、単一のGET /workspaces/{workspaceId}エンドポイントを、メタデータと子リストを分離するGET /workspaces/{workspaceId}/metadataとGET /workspaces/{workspaceId}/childrenという2つの専用エンドポイントに置き換えることで再設計された。
テンプレート検出エンドポイントが削除された。GET /templatesとGET /templates/publicはどちらも非推奨となった。代替手段として、Smartsheetではワークスペースまたはフォルダーの子エンドポイント（GET /workspaces/{workspaceId}/childrenおよびGET /folders/{folderId}/children）をchildrenResourceTypes=sheets,templatesと組み合わせて使用し、ワークスペースまたはフォルダーにスコープされたテンプレートを一覧表示することを推奨している。
フォルダーの一覧表示と取得操作は、子要素とメタデータに焦点を当てたエンドポイントに統合された。以前のGET /folders/{folderId}/foldersとGET /workspaces/{workspaceId}/foldersは、フォルダーのみの一覧表示が必要な場合にchildrenResourceTypes=foldersを指定してGET /folders/{folderId}/childrenとGET /workspaces/{workspaceId}/childrenに置き換えられた。単一のGET /folders/{folderId}呼び出しは、GET /folders/{folderId}/metadataとGET /folders/{folderId}/childrenに分割された。
スケーラビリティーと一貫性を向上させるため、アセット固有の共有エンドポイントは削除され、統一された共有APIが導入された。Smartsheetは、シート、レポート、サイト、ワークスペース固有の多数の共有ルートを置き換えるため、GET /shares、GET /shares/{shareId}、POST /shares、PATCH /shares/{shareId}、DELETE /shares/{shareId}という統合されたエンドポイントセットを指定した。
出典：Smartsheet
この製品の詳細については、Smartsheet製品ページをご覧ください。
