---
description: >-
  Statuses reflect the current stage of an Idea or feature request for your
  product as it progresses from suggestion, through development, to completion.
---

# Statuses

## Status object

Status have the following fields

| Field                                   | Details                                                 |
| --------------------------------------- | ------------------------------------------------------- |
| <p><strong>idx</strong><br>string</p>   | A unique identifier for the idea                        |
| <p><strong>name</strong><br>string</p>  | Name of the status                                      |
| <p><strong>color</strong><br>string</p> | Color associated with the status (displayed in the App) |

### Endpoints

You can use the following endpoints to manage Statuses

#### List statuses

{% openapi src="https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-a4f5a86b2b0eb03acffe38febc5b2b73cbb0c071%2Fstatuses.yaml?alt=media" path="/statuses" method="get" %}
[statuses.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-a4f5a86b2b0eb03acffe38febc5b2b73cbb0c071%2Fstatuses.yaml?alt=media)
{% endopenapi %}

#### Create a status

{% openapi src="https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-a4f5a86b2b0eb03acffe38febc5b2b73cbb0c071%2Fstatuses.yaml?alt=media" path="/statuses" method="post" %}
[statuses.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-a4f5a86b2b0eb03acffe38febc5b2b73cbb0c071%2Fstatuses.yaml?alt=media)
{% endopenapi %}

#### Update a status

{% openapi src="https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-a4f5a86b2b0eb03acffe38febc5b2b73cbb0c071%2Fstatuses.yaml?alt=media" path="/statuses/{statusIdx}" method="post" %}
[statuses.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-a4f5a86b2b0eb03acffe38febc5b2b73cbb0c071%2Fstatuses.yaml?alt=media)
{% endopenapi %}

#### Delete a status

{% openapi src="https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-a4f5a86b2b0eb03acffe38febc5b2b73cbb0c071%2Fstatuses.yaml?alt=media" path="/statuses/{statusIdx}" method="delete" %}
[statuses.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-a4f5a86b2b0eb03acffe38febc5b2b73cbb0c071%2Fstatuses.yaml?alt=media)
{% endopenapi %}
