This endpoint retrieves a list of all workbooks available. You can use the response from this endpoint to display a dashboard or a management interface where users can select their existing workbooks.
Usage Notes
This endpoint requires no parameters for basic requests, but supports query parameters for pagination and response limit.
Pagination
This endpoint supports pagination, which lets you retrieve large datasets in manageable segments. The response includes pagination details as follows:
- hasMore: A boolean value indicating whether there are more pages of data available beyond the current page.
- total: The total number of entries available across all pages.
- nextPage: An identifier or token that you can use in a subsequent request to retrieve the next page of data.
Example response for pagination
{
"hasMore": true,
"total": 104,
"nextPage": "50"
}
To request additional pages, include the nextPage option in your followup request according to the endpoint's parameter requirements. This process can be repeated until the hasMore option returns false, indicating that no further data is available.
Usage Scenarios
- Workbook Navigation: Allows users to easily navigate through their collection of workbooks and access the one they need.
- Integration Points: Useful for building integrations that need to present users with a list of their available workbooks, such as in custom applications using Sigma Embeds.