Stages
Get Stage Info
Get detailed information about a specific stage including its topics.
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

