Skip to main content
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 publishedAt set (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 roadmapId and stageId are required
  • Only published topics are returned (draft topics excluded)
  • Topics include vote and comment counts
  • Stage must belong to the specified roadmap