Features
Features group a project's tasks into a deliverable that is planned, ordered and shipped as one. Access follows the project's task permissions.
List features
Lists the features the caller can see, ordered by project and name. `status` defaults to `active` (or `shipped`, `all`); filter by `project_id`, and `editable=true` keeps only features whose tasks the caller may edit.
Create feature
Creates a feature in a project, with the caller as lead unless `lead_id` names another. Requires permission to create tasks in that project; an unknown or inaccessible project returns 422. Returns the created feature.
Reorder features
Sets the display order of a project's active features from the full list of their ids; shipped features keep their position. Requires permission to edit tasks in the project. Returns 204 with no body.
Delete feature
Deletes a feature. Its tasks stay in the project, unchanged, with no feature. Returns 204 with no body.
Get feature
Returns one feature, shipped ones included, with its project, lead, status, icon and whether the caller may edit it.
Update feature
Changes a feature's name, description, icon or lead, including on a shipped feature. A null `description` or `icon` clears it; `name` and `lead_id` cannot be null. Returns the updated feature.
List lead candidates
Lists the people who may lead this feature: members of its organization who can edit tasks in its project, ordered by name. Requires permission to edit tasks there.
Reopen feature
Moves a shipped feature back to active and clears who shipped it and when; its tasks are not touched. Repeating the call changes nothing. Returns the feature.
Ship feature
Marks a feature shipped, recording who and when; it leaves the active list and accepts no more tasks. Its tasks keep their state, and repeating the call changes nothing. Returns the feature.