# STORY BOARDS

Invoke the Story Boards API to retrieve and manage Story Boards. Story Boards are curated content experiences that combine collections, saved searches, and other content blocks into a single shareable view.

**Coming Soon:** Additional endpoints for creating, updating, and deleting Story Boards.

## (COMING SOON!) List Story Boards

 - [GET /storyboards](https://api.tenovos.com/openapi/v1.5/story-boards/liststoryboards.md): 🚧 Coming Soon — This endpoint is not yet available for external consumption.

Retrieve a paginated list of Story Boards. Supports cursor-based pagination, search by title/description, sorting, and filtering by publish status and locale.

Access Control:
- Only Story Boards the user has view access to are returned
- If the user does not have the viewStoryboards role privilege, an empty array is returned
- Only published boards are returned unless the user has Story Board management permission
- Permissions (canDelete, canApplySecurityTemplates, canShareInternal, canShareExternal, canPublish) are resolved server-side based on the user's role privileges and security template permissions

Pagination:
- Uses cursor-based pagination for consistent results across large and changing lists
- Always use the same sortBy and sortOrder values across all pages of a paginated request
- If sort parameters change, discard the current cursor and start a new request

The user submitting the request must have the viewStoryboards role privilege.