API

Features API

Endpoints for listing and creating feature requests.

List Features

Get all features for an app, including vote counts and user vote status.

GET/api/apps/{appId}/features

Query Parameters

Parameter	Type	Description
`user_id`	string	Include to get has_voted status for each feature

Response

200 OK

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "Dark mode support",
    "description": "Add a dark theme option",
    "status": "planned",
    "created_at": "2024-01-15T10:30:00Z",
    "vote_count": 24,
    "comment_count": 5,
    "has_voted": true
  },
  {
    "id": "223e4567-e89b-12d3-a456-426614174001",
    "title": "Export to CSV",
    "description": "Allow exporting data to CSV format",
    "status": "open",
    "created_at": "2024-01-14T09:00:00Z",
    "vote_count": 18,
    "comment_count": 3,
    "has_voted": false
  }
]

Create Feature

Submit a new feature request.

POST/api/apps/{appId}/features

Headers

Content-Type: application/json
x-user-id: {user_id}
x-user-name: {user_name}
x-user-email: {user_email} (optional)

Request Body

{
  "title": "Dark mode support",
  "description": "Add a dark theme option for better viewing at night"
}

Parameter	Type	Description
`title`Required	string	Feature title (3-200 characters)
`description`Required	string	Feature description (10-2000 characters)

Response

201 Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "Dark mode support",
  "description": "Add a dark theme option for better viewing at night",
  "status": "open",
  "created_at": "2024-01-15T10:30:00Z",
  "vote_count": 1,
  "comment_count": 0,
  "has_voted": true
}

Auto Vote

The creator automatically votes for their own feature request.

Feature Status Values

Parameter	Type	Description
`open`	-	New feature request, not yet reviewed
`planned`	-	Accepted and planned for development
`in_progress`	-	Currently being developed
`done`	-	Completed and released