Initiatives API

Create an initiative

POST /api/v1/products/:product_id/initiatives

Parameters
Name	Description
`product_id *`	Numeric ID or key of the product
`name *`	Name of the initiative
`workflow_status *`	Status of the initiative.
`description`	Description of the initiative — may include HTML formatting.
`effort`	Effort required for the initiative
`value`	Value the initiative brings to the business
`parent_id`	ID of an initiative to roll up to in the parent line, Roll up an initiative to a parent line initiative by 1) creating an initiative for the parent line 2) choosing that initiative in this control. You can then visualize how releases relate to your strategic initiatives throughout Aha!
`position`	Used to sort initiatives
`presented`	Whether this initiative is shown on charts
`start_date`	Start date for the initiative in format YYYY-MM-DD
`end_date`	End date for the initiative in format YYYY-MM-DD
`time_frame`	Name or ID of time frame for this initiative
`progress_source`	Source for calculating progress on the initiative. Options are: progress_manual, progress_from_features, progress_from_releases, progress_from_children, progress_from_features_completed, progress_from_epics.
`progress`	Progress completed on the initiative. May only be set when the progress_source is manual.
`duration_source`	Source for automatically calculating start and end dates. Options are: duration_manual, duration_from_children, duration_from_releases, duration_from_features_epics.

Example request

POST /api/v1/products/PRJ1/initiatives

Example CURL command

curl "https://company.aha.io/api/v1/products/PRJ1/initiatives" -d '{"initiative":{"name":"Initiative 3","workflow_status":{"name":"Not Started"},"description":"Our first big initiative","time_frame":{"id":813624702},"effort":15,"value":5,"presented":true}}' -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