Ideas API
When creating an idea where the creator is an idea user we strongly suggest
to provide the submitted_idea_portal_id
attribute to the idea
to ensure that the idea is created in the correct ideas portal and the user
gets access to the portal.
If you don't want the idea to be submitted to any portal, you can skip this
by setting skip_portal: true
in the request body.
Create an idea with comma-separated tags
POST /api/v1/products/:product_id/ideas
Name | Description |
---|---|
product_id * | Numeric ID or key of the product |
submitted_idea_portal_id | Numeric ID of the ideas portal. We strongly suggest you set this if the creator is an idea user. |
name * | Name of the idea |
description | Description of the idea — may include HTML formatting. |
workflow_status | Status of the idea — must be a valid status for the selected product. |
tags | Tags to add to the idea. Multiple tags must be separated by commas. |
categories | Names of any existing categories the idea should be assigned to. Multiple categories must be separated by commas. |
created_by * | Email address of user who created the idea — does not need to be an Aha! user email. |
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 |
epic | Epic ID of the epic 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. Note that in the API response, this attribute is called duplicate_of. |
initial_votes | Number of votes to seed the vote count with when importing from other systems |
visibility | Initial visibility of the idea (aha, creator, employee, employee_or_creator, creator_organization, or public - aha is the default) |
created_at | Date of idea creation. In UTC timezone with format YYYY-MM-DD or YYYY-MM-DD HH:MM:SS. |
spam | Whether the idea is considered spam. Must be 'true' or 'false' |
Example request
POST /api/v1/products/PRJ1/ideas
Example CURL command
curl "https://company.aha.io/api/v1/products/PRJ1/ideas" -d '{"idea":{"name":"New idea","tags":"tag1, tag2"}}' -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