Topics
List Topics
Get all published topics (feature requests) for a specific roadmap stage. Supports sorting and pagination.
POST
Authentication
Request Body
string
required
Roadmap ID (UUID)
string
required
Stage ID (UUID) to filter topics by
string
default:"createdAt"
Field to sort by (createdAt, updatedAt, title)
string
default:"DESC"
Sort direction (ASC or DESC)
Response
array
Array of topic objects
object
Pagination metadata
Behavior
- Published Only: Only returns topics with
publishedAtset (not null) - Stage Filtering: Topics filtered by specific roadmap stage
- Sorted: Returns topics sorted by specified field
- Pagination: Supports offset/limit pagination
Use Cases
- Roadmap Display: Show feature requests by stage
- Public Roadmap: Display planned features to users
- Feature Voting: List features for users to vote on
Notes
- Both
roadmapIdandstageIdare required - Only published topics are returned (draft topics excluded)
- Topics include vote and comment counts
- Stage must belong to the specified roadmap

