get https://api.sigmacomputing.com/v2/workspaces
Attention: This API endpoint is transitioning to a paginated format to enhance performance and scalability. The API will maintain backward compatibility during this transition. To start receiving paginated responses, include the query parameter limit
in your requests.
This endpoint returns a list of all workspaces. You can use pagination and optionally filter by name to manage large datasets. See Manage Workspaces for more details about workspaces in Sigma.
Usage notes
- Filtering by name: Optionally, use the
name
parameter to filter workspaces by name.
Usage scenarios
- Pagination: Use the
page
andlimit
parameters to control the size and segment of the workspace list returned. - 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.