Statuses

Statuses represent the statues an idea can have

Status object

Status have the following fields

Field	Details
idx string	A unique identifier for the idea
name string	Name of the status
color string	Color associated with the status (displayed in the App)

Endpoints

You can use the following endpoints to manage Statuses

List statuses

Returns a list of statuses

GEThttps://api.frill.co/v1/statuses

Query parameters

Response

200400

Successfully returned a list of statuses

Body

application/json

dataarray of Status (object)

paginationPagination (object)

Request

JavaScriptCurl

const response = await fetch('https://api.frill.co/v1/statuses', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "idx": "status_abcd1234",
      "name": "Completed",
      "color": "#ff00ff",
      "created_at": "text",
      "updated_at": "text"
    }
  ],
  "pagination": {
    "total": 10,
    "before": "before-cursor",
    "after": "after-cursor"
  }
}

Create a status

Create a new status

POSThttps://api.frill.co/v1/statuses

Body

application/json

namestring

Response

200400

Successfully created a new status

Body

application/json

idx*string

A unique identifier for the status

namestring

Name of the status

colorstring

Color associated with the status (displayed in the App)

created_atstring

The date & time the Status was last updated (UTC timezone)

updated_atstring

The date & time the Status was last updated (UTC timezone)

Request

JavaScriptCurl

const response = await fetch('https://api.frill.co/v1/statuses', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "idx": "status_abcd1234",
  "name": "Completed",
  "color": "#ff00ff",
  "created_at": "text",
  "updated_at": "text"
}

Update a status

Update a Status

POSThttps://api.frill.co/v1/statuses/{statusIdx}

Path parameters

statusIdx*string

Body

application/json

namestring

Response

200400

Successfully updated a status

Body

application/json

idx*string

A unique identifier for the status

namestring

Name of the status

colorstring

Color associated with the status (displayed in the App)

created_atstring

The date & time the Status was last updated (UTC timezone)

updated_atstring

The date & time the Status was last updated (UTC timezone)

Request

JavaScriptCurl

const response = await fetch('https://api.frill.co/v1/statuses/{statusIdx}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "idx": "status_abcd1234",
  "name": "Completed",
  "color": "#ff00ff",
  "created_at": "text",
  "updated_at": "text"
}

Delete a status

Delete a Status

DELETEhttps://api.frill.co/v1/statuses/{statusIdx}

Path parameters

statusIdx*string

Response

200400

Request was successful

Body

application/json

successboolean

messagestring

Request

JavaScriptCurl

const response = await fetch('https://api.frill.co/v1/statuses/{statusIdx}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

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