Ideas

Ideas are feedback or suggestions submitted by customers to your Frill account. Each idea can be assigned a Status and categorized under multiple Topics.

Idea object

Ideas have the following fields

Field

Details

idx string

A unique identifier for the idea

name string

The name of the idea

slug string

The URL slug of the idea

description string

The text description of the idea

cover_image string

Url of the image displayed as the cover on the Roadmap view

vote_count number

Number of votes this idea has received

comment_count number

Number of comments on this idea

note_count number

Number of internal notes on this idea

is_pined boolean

Has the idea been pinned to the top

is_bug boolean

Denotes if this idea is a bug

is_archived boolean

Denotes if this idea has been archived

is_completed boolean

Denotes if this idea is considered completed / finished

show_in_roadmap boolean

Should the idea be displayed in the Roadmap view

approval_status string

The approval status of the idea

created_at string

The date & time the idea was created in UTC timezone

author object

Author of the idea

status object

Status of the idea

topics array

Topics associated with the idea

Endpoints

You can use the following endpoints to manage Ideas

get

Returns a list of ideas

Authorizations

Query parameters

limitintegerOptional

Limits the number of items on a page

Default: 20

afterstringOptional

The after cursor - used for pagination

sortstring · enumOptional

The field so sort by

Default: created_atPossible values:

sortBystring · enumOptional

The direction to sort

Default: descPossible values:

Responses

200

Successfully returned a list of ideas

application/json

400

Invalid request

application/json

get

GET /v1/ideas HTTP/1.1
Host: api.frill.co
Authorization: Basic username:password
Accept: */*

{
  "data": [
    {
      "idx": "idea_abcd1234",
      "name": "New idea",
      "slug": "new-idea",
      "description": "This is a new idea from a customer",
      "cover_image": "https://example.com/example.jpg",
      "vote_count": 1,
      "comment_count": 1,
      "note_count": 1,
      "is_pined": true,
      "is_bug": true,
      "is_archived": true,
      "is_completed": true,
      "show_in_roadmap": true,
      "approval_status": "text",
      "created_at": "text",
      "updated_at": "text",
      "author": {
        "idx": "user_abcd1234",
        "name": "John Smith",
        "avatar": "https://example.com/example.jpg"
      },
      "status": {
        "idx": "status_abcd1234",
        "name": "Completed",
        "color": "#6392D9"
      },
      "topics": [
        [
          {
            "idx": "topic_abcd1234",
            "name": "New feature"
          }
        ]
      ]
    }
  ],
  "pagination": {
    "total": 10,
    "before": "before-cursor",
    "after": "after-cursor"
  }
}

post

Create a new idea

Authorizations

Body

author_idxstringRequired

A unique identifier for the idea author

Example: follower_abcd1234

namestringRequired

The name of the idea

Example: New idea

descriptionstringRequired

The text description of the idea

Example: This is a new idea from a customer

status_idxstringOptional

A unique identifier for the idea status

Example: status_abcd1234

topic_idxsarrayOptional

array of unique identifiers for the idea topics

is_pinedbooleanOptional

Has the idea been pinned to the top

is_archivedbooleanOptional

Denotes if this idea has been archived

show_in_roadmapbooleanOptional

Should the idea be displayed in the Roadmap view

Responses

200

Successfully created a new idea

application/json

400

Invalid request

application/json

post

POST /v1/ideas HTTP/1.1
Host: api.frill.co
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 208

{
  "author_idx": "follower_abcd1234",
  "name": "New idea",
  "description": "This is a new idea from a customer",
  "status_idx": "status_abcd1234",
  "topic_idxs": [],
  "is_pined": true,
  "is_archived": true,
  "show_in_roadmap": true
}

{
  "data": {
    "idx": "idea_abcd1234",
    "name": "New idea",
    "slug": "new-idea",
    "description": "This is a new idea from a customer",
    "cover_image": "https://example.com/example.jpg",
    "vote_count": 1,
    "comment_count": 1,
    "note_count": 1,
    "is_pined": true,
    "is_bug": true,
    "is_archived": true,
    "is_completed": true,
    "show_in_roadmap": true,
    "approval_status": "text",
    "created_at": "text",
    "updated_at": "text",
    "author": {
      "idx": "user_abcd1234",
      "name": "John Smith",
      "avatar": "https://example.com/example.jpg"
    },
    "status": {
      "idx": "status_abcd1234",
      "name": "Completed",
      "color": "#6392D9"
    },
    "topics": [
      [
        {
          "idx": "topic_abcd1234",
          "name": "New feature"
        }
      ]
    ]
  }
}

get

Get an Idea

Authorizations

Path parameters

ideaIdxOrSlugstringRequired

IDX or Slug of the Idea

Responses

200

Return idea

application/json

400

Invalid request

application/json

get

GET /v1/ideas/{ideaIdxOrSlug} HTTP/1.1
Host: api.frill.co
Authorization: Basic username:password
Accept: */*

{
  "data": {
    "idx": "idea_abcd1234",
    "name": "New idea",
    "slug": "new-idea",
    "description": "This is a new idea from a customer",
    "cover_image": "https://example.com/example.jpg",
    "vote_count": 1,
    "comment_count": 1,
    "note_count": 1,
    "is_pined": true,
    "is_bug": true,
    "is_archived": true,
    "is_completed": true,
    "show_in_roadmap": true,
    "approval_status": "text",
    "created_at": "text",
    "updated_at": "text",
    "author": {
      "idx": "user_abcd1234",
      "name": "John Smith",
      "avatar": "https://example.com/example.jpg"
    },
    "status": {
      "idx": "status_abcd1234",
      "name": "Completed",
      "color": "#6392D9"
    },
    "topics": [
      [
        {
          "idx": "topic_abcd1234",
          "name": "New feature"
        }
      ]
    ]
  }
}

post

Update an Idea

Authorizations

Path parameters

ideaIdxstringRequired

IDX of the Idea

Body

author_idxstringRequired

A unique identifier for the idea author

Example: follower_abcd1234

namestringRequired

The name of the idea

Example: New idea

descriptionstringRequired

The text description of the idea

Example: This is a new idea from a customer

status_idxstringOptional

A unique identifier for the idea status

Example: status_abcd1234

topic_idxsarrayOptional

array of unique identifiers for the idea topics

is_pinedbooleanOptional

Has the idea been pinned to the top

is_archivedbooleanOptional

Denotes if this idea has been archived

show_in_roadmapbooleanOptional

Should the idea be displayed in the Roadmap view

Responses

200

Successfully updated an idea

application/json

400

Invalid request

application/json

post

POST /v1/ideas/{ideaIdx} HTTP/1.1
Host: api.frill.co
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 208

{
  "author_idx": "follower_abcd1234",
  "name": "New idea",
  "description": "This is a new idea from a customer",
  "status_idx": "status_abcd1234",
  "topic_idxs": [],
  "is_pined": true,
  "is_archived": true,
  "show_in_roadmap": true
}

{
  "data": {
    "idx": "idea_abcd1234",
    "name": "New idea",
    "slug": "new-idea",
    "description": "This is a new idea from a customer",
    "cover_image": "https://example.com/example.jpg",
    "vote_count": 1,
    "comment_count": 1,
    "note_count": 1,
    "is_pined": true,
    "is_bug": true,
    "is_archived": true,
    "is_completed": true,
    "show_in_roadmap": true,
    "approval_status": "text",
    "created_at": "text",
    "updated_at": "text",
    "author": {
      "idx": "user_abcd1234",
      "name": "John Smith",
      "avatar": "https://example.com/example.jpg"
    },
    "status": {
      "idx": "status_abcd1234",
      "name": "Completed",
      "color": "#6392D9"
    },
    "topics": [
      [
        {
          "idx": "topic_abcd1234",
          "name": "New feature"
        }
      ]
    ]
  }
}

delete

Delete an Idea

Authorizations

Path parameters

ideaIdxstringRequired

IDX of the Idea

Responses

200

Request was successful

application/json

400

Invalid request

application/json

delete

DELETE /v1/ideas/{ideaIdx} HTTP/1.1
Host: api.frill.co
Authorization: Basic username:password
Accept: */*

{
  "success": true,
  "message": "Request was successful"
}

PreviousAnnouncement Categories NextStatuses

Last updated 8 months ago