Ideas API

When creating an idea where the creator is an idea user we strongly suggest to provide the submitted_idea_portal_id attribute to the idea to ensure that the idea is created in the correct ideas portal and the user gets access to the portal.

If you don't want the idea to be submitted to any portal, you can skip this by setting skip_portal: true in the request body.

List ideas

GET /api/v1/ideas

Parameters
Name	Description
`q`	Search term to match against the idea name
`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.
`sort`	Sorting of the list of ideas. Accepted values are `recent`, `trending`, or `popular`.
`created_before`	UTC timestamp (in ISO8601 format). If provided, only ideas created before the timestamp will be returned.
`created_since`	UTC timestamp (in ISO8601 format). If provided, only ideas created after the timestamp will be returned.
`updated_since`	UTC timestamp (in ISO8601 format). If provided, only ideas updated or created after the timestamp will be returned.
`tag`	String tag value. If provided, only ideas with the associated tag will be returned.
`user_id`	ID of a user. If provided, only ideas created by that user will be returned.
`idea_user_id`	ID of an idea user. If provided, only ideas created by that idea user will be returned.

Example request

GET /api/v1/ideas

Example CURL command

curl -g "https://company.aha.io/api/v1/ideas" -X GET \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

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

Response

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

Response body