get https://api.sigmacomputing.com/v2.1/workspaces
Attention: This API endpoint uses pagination by default.
This endpoint returns all workspaces. See Manage Workspaces for more details about workspaces in Sigma.
Usage notes
- Pagination: Use the
page
andlimit
parameters to control the size and segment of the workspace list returned. - Filtering by name: Optionally, use the
name
parameter to filter workspaces by name.
Usage scenarios
- User interface display: Populate a user interface with a list of all available workspaces, using pagination to efficiently load data and filtering to quickly find specific workspaces.
- Administrative overview: Provide system administrators with an overview of all workspaces for management and monitoring purposes, with the ability to browse through pages and search by name.
Best practices
- Use caching to reduce load times and server demand when frequently accessing workspace lists.
- Regularly update and synchronize workspace lists to ensure that displayed information is current and accurate.