| Name | Description |
|---|---|
| product_id * | Numeric ID, or key of the product the idea should be created in |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
POST /api/v1/products/PRJ1/ideas
curl "https://account1.aha.io/api/v1/products/PRJ1/ideas" -d '{"idea":{"name":"New idea","description":"\u003cp\u003eThis is the description\u003c/p\u003e","initial_votes":3}}' -X POST \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"name": "New idea",
"description": "<p>This is the description</p>",
"initial_votes": 3
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "6580368989590085394",
"name": "New idea",
"reference_num": "PRJ1-I-2",
"score": 2,
"created_at": "2018-07-20T18:32:27.324Z",
"updated_at": "2018-07-20T18:32:27.382Z",
"product_id": 131414752,
"votes": 3,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580368989669495585",
"body": "<p>This is the description</p>",
"created_at": "2018-07-20T18:32:27.345Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:27.389Z"
},
"assigned_to_user": null,
"endorsements_count": 0,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
}
}
| Name | Description |
|---|---|
| product_id * | Numeric ID, or key of the product the idea should be created in |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
POST /api/v1/products/PRJ1/ideas
curl "https://account1.aha.io/api/v1/products/PRJ1/ideas" -d '{"idea":{"name":"New idea","created_by_portal_user":{"id":646391926,"name":"John Long"}}}' -X POST \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"name": "New idea",
"created_by_portal_user": {
"id": 646391926,
"name": "John Long"
}
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "6580368992503082571",
"name": "New idea",
"reference_num": "PRJ1-I-2",
"score": 2,
"created_at": "2018-07-20T18:32:28.004Z",
"updated_at": "2018-07-20T18:32:28.280Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580368992586581259",
"body": "",
"created_at": "2018-07-20T18:32:28.023Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_portal_user": {
"id": "646391926",
"name": "John Long",
"email": "john@long.com",
"created_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"endorsements_count": 0,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
}
}
| Name | Description |
|---|---|
| product_id * | Numeric ID, or key of the product the idea should be created in |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
POST /api/v1/products/PRJ1/ideas
curl "https://account1.aha.io/api/v1/products/PRJ1/ideas" -d '{"fields":"*,watchers","idea":{"name":"New idea","watchers":"689956296,16338845"}}' -X POST \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"fields": "*,watchers",
"idea": {
"name": "New idea",
"watchers": "689956296,16338845"
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "6580369001062560966",
"name": "New idea",
"reference_num": "PRJ1-I-2",
"score": 2,
"created_at": "2018-07-20T18:32:29.996Z",
"updated_at": "2018-07-20T18:32:30.055Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369001190719398",
"body": "",
"created_at": "2018-07-20T18:32:30.023Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:30.064Z"
},
"assigned_to_user": null,
"endorsements_count": 0,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
],
"watchers": [
{
"id": "16338845",
"name": "John Smith",
"email": "john.smith@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:31:42.000Z"
},
{
"id": "689956296",
"name": "Henry Humpty",
"email": "henry.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:31:42.000Z"
},
{
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:30.064Z"
}
]
}
}
| Name | Description |
|---|---|
| product_id * | Numeric ID, or key of the product the idea should be created in |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
POST /api/v1/products/PRJ1/ideas
curl "https://account1.aha.io/api/v1/products/PRJ1/ideas" -d '{"idea":{"name":"New idea","score_facts":[{"name":"Benefit","value":12},{"name":"Effort","value":3}]}}' -X POST \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"name": "New idea",
"score_facts": [
{
"name": "Benefit",
"value": 12
},
{
"name": "Effort",
"value": 3
}
]
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "6580369002480388517",
"name": "New idea",
"reference_num": "PRJ1-I-2",
"score": 15,
"created_at": "2018-07-20T18:32:30.322Z",
"updated_at": "2018-07-20T18:32:30.425Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369002658957775",
"body": "",
"created_at": "2018-07-20T18:32:30.365Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:30.429Z"
},
"assigned_to_user": null,
"endorsements_count": 0,
"comments_count": 0,
"score_facts": [
{
"id": "6580369002828543838",
"value": 3,
"name": "Effort"
},
{
"id": "6580369002549876349",
"value": 12,
"name": "Benefit"
}
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
}
}
| Name | Description |
|---|---|
| product_id * | Numeric ID, or key of the product the idea should be created in |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
POST /api/v1/products/PRJ1/ideas
curl "https://account1.aha.io/api/v1/products/PRJ1/ideas" -d '{"idea":{"name":"New idea","custom_fields":{"priority":"P3"}}}' -X POST \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"name": "New idea",
"custom_fields": {
"priority": "P3"
}
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "6580369004190136784",
"name": "New idea",
"reference_num": "PRJ1-I-2",
"score": 2,
"created_at": "2018-07-20T18:32:30.721Z",
"updated_at": "2018-07-20T18:32:30.782Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369004245110082",
"body": "",
"created_at": "2018-07-20T18:32:30.737Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:30.790Z"
},
"assigned_to_user": null,
"endorsements_count": 0,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
{
"key": "priority",
"name": "Priority",
"value": "P3",
"type": "string"
}
]
}
}
| Name | Description |
|---|---|
| product_id * | Numeric ID, or key of the product the idea should be created in |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
POST /api/v1/products/PRJ1/ideas
curl "https://account1.aha.io/api/v1/products/PRJ1/ideas" -d '{"idea":{"name":"New idea","visibility":"public"}}' -X POST \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"name": "New idea",
"visibility": "public"
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "6580369005613253720",
"name": "New idea",
"reference_num": "PRJ1-I-2",
"score": 2,
"created_at": "2018-07-20T18:32:31.053Z",
"updated_at": "2018-07-20T18:32:31.105Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369005681022413",
"body": "",
"created_at": "2018-07-20T18:32:31.069Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:31.115Z"
},
"assigned_to_user": null,
"endorsements_count": 0,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
}
}
| Name | Description |
|---|---|
| product_id * | Numeric ID, or key of the product the idea should be created in |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
POST /api/v1/products/PRJ1/ideas
curl "https://account1.aha.io/api/v1/products/PRJ1/ideas" -d '{"idea":{"name":"New idea","created_at":"2014-01-11T00:01:02Z"}}' -X POST \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"name": "New idea",
"created_at": "2014-01-11T00:01:02Z"
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "6580369010122087057",
"name": "New idea",
"reference_num": "PRJ1-I-2",
"score": 2,
"created_at": "2014-01-11T00:01:02.000Z",
"updated_at": "2018-07-20T18:32:32.166Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369010233605166",
"body": "",
"created_at": "2018-07-20T18:32:32.129Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:32.172Z"
},
"assigned_to_user": null,
"endorsements_count": 0,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
}
}
| Name | Description |
|---|---|
| q | Sub-string to match against idea name or ID |
| spam | When 'true', shows ideas that have been marked as spam. By default, no spam ideas will be shown. |
| workflow_status | When present, filters to ideas with the provided workflow status ID or name |
GET /api/v1/ideas
curl -g "https://account1.aha.io/api/v1/ideas" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
},
{
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
},
{
"id": "162120796",
"reference_num": "PRJ1-I-5",
"name": "Idea 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "478357480",
"body": "Description of idea custom tables",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-5",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-5"
},
{
"id": "58056975",
"reference_num": "PRJ1-I-1",
"name": "Idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
},
{
"id": "397084149",
"reference_num": "PRJ1-I-6",
"name": "Some idea name 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "868056987",
"body": "Description of idea endorsement 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-6",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-6"
},
{
"id": "290908627",
"reference_num": "PRJ1-I-9",
"name": "Some idea name 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369012658381112",
"body": "",
"created_at": "2018-07-20T18:32:32.695Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-9",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-9"
},
{
"id": "245519441",
"reference_num": "PRJ1-I-7",
"name": "Some idea name 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "716451363",
"body": "Description of idea endorsement 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-7",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-7"
},
{
"id": "140490859",
"reference_num": "PRJ1-I-8",
"name": "Some idea name 3",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369012871242895",
"body": "",
"created_at": "2018-07-20T18:32:32.745Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-8",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-8"
}
],
"pagination": {
"total_records": 8,
"total_pages": 1,
"current_page": 1
}
}
| Name | Description |
|---|---|
| q | Sub-string to match against idea name or ID |
| spam | When 'true', shows ideas that have been marked as spam. By default, no spam ideas will be shown. |
| workflow_status | When present, filters to ideas with the provided workflow status ID or name |
GET /api/v1/ideas
curl -g "https://account1.aha.io/api/v1/ideas" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
},
{
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
},
{
"id": "162120796",
"reference_num": "PRJ1-I-5",
"name": "Idea 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "478357480",
"body": "Description of idea custom tables",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-5",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-5"
},
{
"id": "58056975",
"reference_num": "PRJ1-I-1",
"name": "Idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
},
{
"id": "397084149",
"reference_num": "PRJ1-I-6",
"name": "Some idea name 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "868056987",
"body": "Description of idea endorsement 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-6",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-6"
},
{
"id": "290908627",
"reference_num": "PRJ1-I-9",
"name": "Some idea name 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369014065864176",
"body": "",
"created_at": "2018-07-20T18:32:33.021Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-9",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-9"
},
{
"id": "245519441",
"reference_num": "PRJ1-I-7",
"name": "Some idea name 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "716451363",
"body": "Description of idea endorsement 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-7",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-7"
},
{
"id": "140490859",
"reference_num": "PRJ1-I-8",
"name": "Some idea name 3",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369014283043444",
"body": "",
"created_at": "2018-07-20T18:32:33.074Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-8",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-8"
}
],
"pagination": {
"total_records": 8,
"total_pages": 1,
"current_page": 1
}
}
GET /api/v1/ideas?workflow_status=1009437757&fields=*%2Cworkflow_status
curl -g "https://account1.aha.io/api/v1/ideas?workflow_status=1009437757&fields=*%2Cworkflow_status" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "1055237874",
"name": "Idea 3 Merged",
"reference_num": "PRJ1-I-3",
"score": 0,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:31:43.000Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"duplicate_of": {
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_portal_user": {
"id": "646391926",
"name": "John Long",
"email": "john@long.com",
"created_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"feature": {
"id": "1007868956",
"reference_num": "PRJ1-1",
"name": "Feature 1",
"created_at": "2018-07-20T18:31:43.000Z",
"url": "http://account1.example.org/features/PRJ1-1",
"resource": "http://account1.example.org/api/v1/features/PRJ1-1",
"product_id": 131414752
},
"endorsements_count": 0,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
},
{
"id": "444379319",
"name": "Idea 2",
"reference_num": "PRJ1-I-2",
"score": 0,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:31:43.000Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"duplicates": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
}
],
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_portal_user": {
"id": "646391926",
"name": "John Long",
"email": "john@long.com",
"created_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"feature": {
"id": "1007868956",
"reference_num": "PRJ1-1",
"name": "Feature 1",
"created_at": "2018-07-20T18:31:43.000Z",
"url": "http://account1.example.org/features/PRJ1-1",
"resource": "http://account1.example.org/api/v1/features/PRJ1-1",
"product_id": 131414752
},
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
}
],
"pagination": {
"total_records": 2,
"total_pages": 1,
"current_page": 1
}
}
| Name | Description |
|---|---|
| q | Sub-string to match against idea name or ID |
| spam | When 'true', shows ideas that have been marked as spam. By default, no spam ideas will be shown. |
| workflow_status | When present, filters to ideas with the provided workflow status ID or name |
GET /api/v1/ideas
curl -g "https://account1.aha.io/api/v1/ideas" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
},
{
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
},
{
"id": "162120796",
"reference_num": "PRJ1-I-5",
"name": "Idea 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "478357480",
"body": "Description of idea custom tables",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-5",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-5"
},
{
"id": "58056975",
"reference_num": "PRJ1-I-1",
"name": "Idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
},
{
"id": "397084149",
"reference_num": "PRJ1-I-6",
"name": "Some idea name 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "868056987",
"body": "Description of idea endorsement 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-6",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-6"
},
{
"id": "290908627",
"reference_num": "PRJ1-I-9",
"name": "Some idea name 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369016379165000",
"body": "",
"created_at": "2018-07-20T18:32:33.563Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-9",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-9"
},
{
"id": "245519441",
"reference_num": "PRJ1-I-7",
"name": "Some idea name 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "716451363",
"body": "Description of idea endorsement 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-7",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-7"
},
{
"id": "140490859",
"reference_num": "PRJ1-I-8",
"name": "Some idea name 3",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369016660501818",
"body": "",
"created_at": "2018-07-20T18:32:33.629Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-8",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-8"
}
],
"pagination": {
"total_records": 8,
"total_pages": 1,
"current_page": 1
}
}
GET /api/v1/ideas?workflow_status=In+progress&fields=*%2Cworkflow_status
curl -g "https://account1.aha.io/api/v1/ideas?workflow_status=In+progress&fields=*%2Cworkflow_status" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "1055237874",
"name": "Idea 3 Merged",
"reference_num": "PRJ1-I-3",
"score": 0,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:31:43.000Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"duplicate_of": {
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_portal_user": {
"id": "646391926",
"name": "John Long",
"email": "john@long.com",
"created_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"feature": {
"id": "1007868956",
"reference_num": "PRJ1-1",
"name": "Feature 1",
"created_at": "2018-07-20T18:31:43.000Z",
"url": "http://account1.example.org/features/PRJ1-1",
"resource": "http://account1.example.org/api/v1/features/PRJ1-1",
"product_id": 131414752
},
"endorsements_count": 0,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
},
{
"id": "444379319",
"name": "Idea 2",
"reference_num": "PRJ1-I-2",
"score": 0,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:31:43.000Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"duplicates": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
}
],
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_portal_user": {
"id": "646391926",
"name": "John Long",
"email": "john@long.com",
"created_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"feature": {
"id": "1007868956",
"reference_num": "PRJ1-1",
"name": "Feature 1",
"created_at": "2018-07-20T18:31:43.000Z",
"url": "http://account1.example.org/features/PRJ1-1",
"resource": "http://account1.example.org/api/v1/features/PRJ1-1",
"product_id": 131414752
},
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
}
],
"pagination": {
"total_records": 2,
"total_pages": 1,
"current_page": 1
}
}
| Name | Description |
|---|---|
| product_id * | Numeric ID, or key of the product to retrieve ideas for |
| sort | Sorting of the list of ideas, can be either recent, trending, popular |
GET /api/v1/products/PRJ1/ideas?sort=trending
curl -g "https://account1.aha.io/api/v1/products/PRJ1/ideas?sort=trending" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
},
{
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
},
{
"id": "162120796",
"reference_num": "PRJ1-I-5",
"name": "Idea 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "478357480",
"body": "Description of idea custom tables",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-5",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-5"
},
{
"id": "58056975",
"reference_num": "PRJ1-I-1",
"name": "Idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
}
],
"pagination": {
"total_records": 4,
"total_pages": 1,
"current_page": 1
}
}
| Name | Description |
|---|---|
| created_since | Filter all ideas created after this DateTime. Should be specified as an ISO8601 string |
GET /api/v1/ideas?created_since=2017-07-20T18%3A32%3A34Z
curl -g "https://account1.aha.io/api/v1/ideas?created_since=2017-07-20T18%3A32%3A34Z" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
},
{
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
},
{
"id": "162120796",
"reference_num": "PRJ1-I-5",
"name": "Idea 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "478357480",
"body": "Description of idea custom tables",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-5",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-5"
},
{
"id": "397084149",
"reference_num": "PRJ1-I-6",
"name": "Some idea name 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "868056987",
"body": "Description of idea endorsement 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-6",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-6"
},
{
"id": "290908627",
"reference_num": "PRJ1-I-9",
"name": "Some idea name 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369019865229378",
"body": "",
"created_at": "2018-07-20T18:32:34.373Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-9",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-9"
},
{
"id": "245519441",
"reference_num": "PRJ1-I-7",
"name": "Some idea name 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "716451363",
"body": "Description of idea endorsement 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-7",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-7"
},
{
"id": "140490859",
"reference_num": "PRJ1-I-8",
"name": "Some idea name 3",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369020121713136",
"body": "",
"created_at": "2018-07-20T18:32:34.432Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-8",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-8"
}
],
"pagination": {
"total_records": 7,
"total_pages": 1,
"current_page": 1
}
}
| Name | Description |
|---|---|
| created_before | Filter all ideas created before this DateTime. Should be specified as an ISO8601 string |
GET /api/v1/ideas?created_before=2017-07-20T18%3A32%3A34Z
curl -g "https://account1.aha.io/api/v1/ideas?created_before=2017-07-20T18%3A32%3A34Z" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "58056975",
"reference_num": "PRJ1-I-1",
"name": "Idea 1",
"created_at": "2016-07-20T18:32:34.614Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
}
],
"pagination": {
"total_records": 1,
"total_pages": 1,
"current_page": 1
}
}
| Name | Description |
|---|---|
| q | Sub-string to match against idea name or ID |
GET /api/v1/ideas?q=dea
curl -g "https://account1.aha.io/api/v1/ideas?q=dea" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
},
{
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
},
{
"id": "162120796",
"reference_num": "PRJ1-I-5",
"name": "Idea 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "478357480",
"body": "Description of idea custom tables",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-5",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-5"
},
{
"id": "58056975",
"reference_num": "PRJ1-I-1",
"name": "Idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
},
{
"id": "397084149",
"reference_num": "PRJ1-I-6",
"name": "Some idea name 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "868056987",
"body": "Description of idea endorsement 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-6",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-6"
},
{
"id": "290908627",
"reference_num": "PRJ1-I-9",
"name": "Some idea name 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369022143943811",
"body": "",
"created_at": "2018-07-20T18:32:34.901Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-9",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-9"
},
{
"id": "245519441",
"reference_num": "PRJ1-I-7",
"name": "Some idea name 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "716451363",
"body": "Description of idea endorsement 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-7",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-7"
},
{
"id": "140490859",
"reference_num": "PRJ1-I-8",
"name": "Some idea name 3",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "6580369022318916174",
"body": "",
"created_at": "2018-07-20T18:32:34.945Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-8",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-8"
}
],
"pagination": {
"total_records": 8,
"total_pages": 1,
"current_page": 1
}
}
| Name | Description |
|---|---|
| product_id * | Numeric ID, or key of the product to retrieve ideas for |
| q | Sub-string to match against idea name or ID |
GET /api/v1/products/PRJ1/ideas?q=dea
curl -g "https://account1.aha.io/api/v1/products/PRJ1/ideas?q=dea" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
},
{
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
},
{
"id": "162120796",
"reference_num": "PRJ1-I-5",
"name": "Idea 4",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "478357480",
"body": "Description of idea custom tables",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-5",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-5"
},
{
"id": "58056975",
"reference_num": "PRJ1-I-1",
"name": "Idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
}
],
"pagination": {
"total_records": 4,
"total_pages": 1,
"current_page": 1
}
}
| Name | Description |
|---|---|
| tag | A string tag value. |
GET /api/v1/ideas?tag=Infrastructure
curl -g "https://account1.aha.io/api/v1/ideas?tag=Infrastructure" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"ideas": [
{
"id": "58056975",
"reference_num": "PRJ1-I-1",
"name": "Idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
}
],
"pagination": {
"total_records": 1,
"total_pages": 1,
"current_page": 1
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be retrieved |
GET /api/v1/ideas/PRJ1-I-1
curl -g "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:31:43.000Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
GET /api/v1/ideas/PRJ1-I-1
curl -g "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:35.789Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"admin_response": {
"id": "6580369025849092534",
"body": "This is a great idea! We'll get started right away.",
"created_at": "2018-07-20T18:32:35.765Z",
"attachments": [
],
"responded_by_user": {
"id": "869174989",
"name": "Dirk Gently",
"email": "dirk.gently@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:31:42.000Z"
}
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:35.797Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be retrieved |
GET /api/v1/ideas/PRJ1-I-1
curl -g "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:31:43.000Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
GET /api/v1/ideas/PRJ1-I-1
curl -g "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:31:43.000Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be retrieved |
| duplicates * | whether duplicates are returned in the response |
GET /api/v1/ideas/PRJ1-I-1?duplicates=true
curl -g "https://account1.aha.io/api/v1/ideas/PRJ1-I-1?duplicates=true" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:31:43.000Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
GET /api/v1/ideas/PRJ1-I-1?duplicates=true
curl -g "https://account1.aha.io/api/v1/ideas/PRJ1-I-1?duplicates=true" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:37.115Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"duplicates": [
{
"id": "444379319",
"reference_num": "PRJ1-I-2",
"name": "Idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2"
}
],
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:37.124Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be retrieved |
| duplicates * | whether duplicates are returned in the response |
GET /api/v1/ideas/PRJ1-I-2?duplicates=true
curl -g "https://account1.aha.io/api/v1/ideas/PRJ1-I-2?duplicates=true" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "444379319",
"name": "Idea 2",
"reference_num": "PRJ1-I-2",
"score": 0,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:31:43.000Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"duplicates": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "1009437757",
"name": "In progress",
"position": 2,
"complete": false,
"color": "#ecdd8f"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
}
],
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_portal_user": {
"id": "646391926",
"name": "John Long",
"email": "john@long.com",
"created_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"feature": {
"id": "1007868956",
"reference_num": "PRJ1-1",
"name": "Feature 1",
"created_at": "2018-07-20T18:31:43.000Z",
"url": "http://account1.example.org/features/PRJ1-1",
"resource": "http://account1.example.org/api/v1/features/PRJ1-1",
"product_id": 131414752
},
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
}
}
GET /api/v1/ideas/PRJ1-I-2?duplicates=true
curl -g "https://account1.aha.io/api/v1/ideas/PRJ1-I-2?duplicates=true" -X GET \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "444379319",
"name": "Idea 2",
"reference_num": "PRJ1-I-2",
"score": 0,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:37.873Z",
"product_id": 131414752,
"votes": 1,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "378547141",
"body": "Description of idea 2",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"duplicates": [
{
"id": "1055237874",
"reference_num": "PRJ1-I-3",
"name": "Idea 3 Merged",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "506957205",
"body": "Description of idea 3",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-3",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-3"
}
],
"duplicate_of": {
"id": "58056975",
"reference_num": "PRJ1-I-1",
"name": "Idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
},
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-2",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-2",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_portal_user": {
"id": "646391926",
"name": "John Long",
"email": "john@long.com",
"created_at": "2018-07-20T18:31:42.000Z"
},
"assigned_to_user": null,
"feature": {
"id": "1007868956",
"reference_num": "PRJ1-1",
"name": "Feature 1",
"created_at": "2018-07-20T18:31:43.000Z",
"url": "http://account1.example.org/features/PRJ1-1",
"resource": "http://account1.example.org/api/v1/features/PRJ1-1",
"product_id": 131414752
},
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
],
"tags": [
],
"full_tags": [
],
"categories": [
],
"custom_fields": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be edited |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
PUT /api/v1/ideas/PRJ1-I-1
curl "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -d '{"name":"New idea name","description":"New description"}' -X PUT \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"name": "New idea name",
"description": "New description"
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "New idea name",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:38.645Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "New description",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:38.659Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be edited |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
PUT /api/v1/ideas/PRJ1-I-1
curl "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -d '{"idea":{"custom_fields":{"priority":"P3"}}}' -X PUT \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"custom_fields": {
"priority": "P3"
}
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:38.987Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:38.992Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "priority",
"name": "Priority",
"value": "P3",
"type": "string"
},
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be edited |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
PUT /api/v1/ideas/PRJ1-I-1
curl "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -d '{"idea":{"visibility":"public"}}' -X PUT \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"visibility": "public"
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:39.274Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:39.283Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be edited |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
PUT /api/v1/ideas/PRJ1-I-1
curl "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -d '{"idea":{"watchers":[689956296]}}' -X PUT \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"watchers": [
689956296
]
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:39.573Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:39.586Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be edited |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
PUT /api/v1/ideas/PRJ1-I-1
curl "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -d '{"idea":{"feature":null}}' -X PUT \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"feature": null
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:39.879Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:39.890Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be edited |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
PUT /api/v1/ideas/PRJ1-I-1
curl "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -d '{"idea":{"master_feature":null}}' -X PUT \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"master_feature": null
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:40.201Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:40.223Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be edited |
| 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 - note that in a CSV file quotes must be used around fields that contain 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 |
| 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) |
PUT /api/v1/ideas/PRJ1-I-1
curl "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -d '{"idea":{"initiative":null}}' -X PUT \
-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
{
"idea": {
"initiative": null
}
}
Status: 200 OK Content-Type: application/json; charset=utf-8
{
"idea": {
"id": "58056975",
"name": "Idea 1",
"reference_num": "PRJ1-I-1",
"score": 15,
"created_at": "2018-07-20T18:31:43.000Z",
"updated_at": "2018-07-20T18:32:40.515Z",
"product_id": 131414752,
"votes": 0,
"workflow_status": {
"id": "3259216",
"name": "New",
"position": 1,
"complete": false,
"color": "#dce7c6"
},
"description": {
"id": "103757394",
"body": "Description of idea 1",
"created_at": "2018-07-20T18:31:43.000Z",
"attachments": [
]
},
"visibility": "Visible to anyone",
"url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
"resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1",
"product": {
"id": "131414752",
"reference_prefix": "PRJ1",
"name": "Project 1",
"product_line": false,
"created_at": "2018-07-20T18:31:43.000Z"
},
"created_by_user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "mary.humpty@account1.com",
"created_at": "2018-07-20T18:31:42.000Z",
"updated_at": "2018-07-20T18:32:40.530Z"
},
"assigned_to_user": null,
"endorsements_count": 1,
"comments_count": 0,
"score_facts": [
{
"id": "244026645",
"value": 10,
"name": "Effort"
},
{
"id": "394452137",
"value": 5,
"name": "Benefit"
}
],
"tags": [
"Infrastructure"
],
"full_tags": [
{
"id": 775582684,
"name": "Infrastructure",
"color": "#7552e0"
}
],
"categories": [
{
"id": "972845454",
"name": "Hard disk drive",
"parent_id": 552935478,
"created_at": "2018-07-20T18:31:42.000Z"
}
],
"custom_fields": [
{
"key": "custom_scorecard_definition",
"name": "Some custom scorecard definition",
"value": 11,
"type": "scorecard",
"score_facts": [
{
"id": "84642379",
"value": 10,
"name": "Effort"
}
]
},
{
"key": "component",
"name": "Component",
"value": "web",
"type": "array"
}
],
"custom_object_links": [
]
}
}
| Name | Description |
|---|---|
| id * | Numeric ID, or key of the idea to be deleted |
DELETE /api/v1/ideas/PRJ1-I-1
curl "https://account1.aha.io/api/v1/ideas/PRJ1-I-1" -d '' -X DELETE \ -H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \ -H "Content-Type: application/json" \ -H "Accept: application/json"
Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab Content-Type: application/json Accept: application/json
Status: 204 No Content