Ideas API

Update an idea

PUT/api/v1/ideas/:id

Parameters
NameDescription
id *

Numeric ID or key of the idea

name

Name of the idea

description

Description of the idea and it can include HTML formatting.

workflow_status

Status of the idea and it must be one of the valid status values for the selected product.

tags

Tags can be automatically assigned to the new idea. If more than one tag is used then tags should be separated by commas.

categories

Names of the existing categories the idea should be assigned to. If more than one category is used then categories should be separated by commas.

created_by *

Email address of user that created the idea. The email address does not need to be for a user of Aha!

assigned_to_user

Email address of user that is assigned the idea.

feature

Feature ID of the feature that the idea was promoted to

initiative

Initiative ID of the initiative that the idea was promoted to

master_feature

Master feature ID of the master feature that the idea was promoted to

duplicate_idea

Idea ID for an idea which this idea duplicates. Setting this value will merge this idea into the provided idea ID; setting it to a null or blank value will unmerge this idea

initial_votes

Number of votes to seed the vote count with when importing from other systems

visibility

Initial visibility of the idea ('aha', 'employee', or 'public' - 'aha' is the default)

Example request

PUT/api/v1/ideas/PRJ1-I-1

Example CURL command

curl "https://company.aha.io/api/v1/ideas/PRJ1-I-1" -d '{"idea":{"name":"New idea name","description":"New description"}}' -X PUT \
	-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

© 2020 Aha! Labs Inc.All rights reserved