Features API

Features belong to releases. This means that if you want to create one then you must scope it to a release.

You can return a result set which is unfiltered, or filter by release , product , or epic. All these means of listing features can be further filtered by specific criteria like name, modification date, tag, or assignee.

Once you have the id of a specific feature, you can inspect, modify, or delete them on the root features resource.

Create a feature with a score

POST /api/v1/releases/:release_id/features

Parameters
Name	Description
`release_id *`	Numeric ID or key of the release
`name *`	Name of the feature
`workflow_kind`	Type of feature
`workflow_status`	Status of the feature — must be a valid status for the selected product.
`release`	Numeric ID or key of the release the feature should be created in.
`description`	Description of the feature — may include HTML formatting.
`created_by`	Email address of the user who created the feature.
`assigned_to_user`	Email address of user that is assigned the feature.
`tags`	Tags to add to the feature. Multiple tags must be separated by commas.
`initial_estimate_text`	The initial estimated effort in time or story points for this feature, depending on the capacity units configured. For time: use min, h, d, w, m. Example: "2d 1h”. 1d = 8h, 1w = 5d, 1m = 22d. For story points: Use p to represent points. Example: "4p”.
`detailed_estimate_text`	The detailed estimated effort in time or story points for this feature, depending on the capacity units configured. For time: use min, h, d, w, m. Example: "2d 1h”. 1d = 8h, 1w = 5d, 1m = 22d. For story points: Use p to represent points. Example: "4p”.
`remaining_estimate_text`	The remaining estimated effort in time or story points for this feature, depending on the capacity units configured. For time: use min, h, d, w, m. Example: "2d 1h”. 1d = 8h, 1w = 5d, 1m = 22d. For story points: Use p to represent points. Example: "4p”.
`initial_estimate`	Set the initial estimated effort in minutes or story points, depending on the capacity units configured.
`detailed_estimate`	Set the detailed estimated effort in minutes or story points, depending on the capacity units configured.
`remaining_estimate`	Set the remaining estimated effort in minutes or story points, depending on the capacity units configured.
`start_date`	Date that work will start on the feature in format YYYY-MM-DD
`due_date`	Date that work is due to be completed on the feature in format YYYY-MM-DD
`release_phase`	Name or id of release phase which the feature belongs to
`initiative`	Name or id of initiative which the feature belongs to
`epic`	Name or id of epic which the feature belongs to
`progress_source`	Source for calculating progress on the feature. Options are: progress_manual, progress_from_requirements, progress_from_remaining_estimate, progress_from_todos.
`progress`	Progress completed on the feature. May only be set when the progress_source is manual.
`team`	Numeric ID or key of the Develop team to assign the feature to.
`team_workflow_status`	Team status of the feature — must be a valid status for the selected team.
`iteration`	ID of sprint to assign the feature to, must belong to the selected team.
`program_increment`	Numeric ID or key of the PI to assign the feature to, must belong to the selected team.

Example request

POST /api/v1/releases/PRJ1-R-1/features

Example CURL command

curl "https://company.aha.io/api/v1/releases/PRJ1-R-1/features" -d '{"feature":{"name":"New feature","workflow_kind":"new","workflow_status":{"name":"Designed"},"score_facts":[{"name":"Benefit","value":10},{"name":"Effort","value":3}]}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
contentType: application/json
accept: application/json

Request body

Response

Status: 200 OK
contentType: application/json; charset=utf-8

Response body