Skip to main content
POST

Authentication

Request Body

string
required
The stage ID to get information for
number
default:"50"
Number of topics to return
number
default:"0"
Number of topics to skip for pagination
string
default:"createdAt"
Field to sort topics by (createdAt, updatedAt, title, voteCount)
string
default:"DESC"
Sort direction (ASC or DESC)

Response

object
Stage object with full details
array
Array of topic objects in this stage
object
Pagination metadata

Behavior

  • Includes Topics: Returns topics currently in this stage
  • Paginated: Topics are paginated for performance
  • Sortable: Topics can be sorted by various fields
  • Public Only: Private stages return 404 for non-team members

Use Cases

  • Stage Detail View: Show all topics in a specific stage
  • Kanban Column: Display topics within a stage column
  • Progress Tracking: Monitor items in each stage

Notes

  • Topics include vote and comment counts
  • Returns 404 if stage is private and user is not a team member
  • Pagination allows efficient loading of stages with many topics
  • Stage metadata includes color for visual customization