Workbooks
List workbook pages for a workbook
This endpoint retrieves a list of all pages contained within a specified workbook. It is useful for applications needing to display an overview or navigate through different pages of a workbook.
Usage notes
- Retrieve the workbookId by calling the /v2/workbooks endpoint.
- To retrieve pages from version-tagged workbooks, pass the tag in the query parameters with the tag name. Retrieve the tag name by calling the /v2/workbooks endpoint and using the tags.name included in the response for a given workbook.
- To retrieve pages from a saved view (formerly called a bookmark), pass the bookmarkId in the query parameters. Retrieve the bookmarkId by calling the /v2/workbooks/{workbookId}/bookmarks or /v2/workbooks/{workbookId}/tags/:tagName/bookmarks endpoints.
Usage scenarios
- Navigation: Helps users and applications navigate through different pages of a workbook efficiently.
- Content Discovery: Allows users to quickly view and access the variety of pages contained within a workbook.
Best practices
- Always name pages to make it easy for users to navigate.
- Utilize pagination to manage and streamline the retrieval of large numbers of pages.
- Ensure that users or systems querying this endpoint have appropriate permissions to access the workbook's content.
get/v2/workbooks/{workbookId}/pages
Request
- Base URLhttps://api.sigmacomputing.com
- AuthHTTP bearer
Path parameters
workbookIdstring required
Unique identifier of the workbook.
Query parameters
pagestring
Use to specify further pages using the string returned in the nextPage portion of the response.
limitnumber double
Number of results to return per page, with a maximum of 1,000 per request. Use the page option in subsequent requests to retrieve the next set of results.
tagstring
bookmarkIdstring
Unique identifier of the saved view (formerly called a bookmark).
Response
The response body.
Changes
No recorded changes to this operation across all 1 revision of this API.