# Topics

### Topic object

Topic have the following fields

| Field                                         | Details                                               |
| --------------------------------------------- | ----------------------------------------------------- |
| <p><strong>idx</strong><br>string</p>         | A unique identifier for the topic                     |
| <p><strong>name</strong><br>string</p>        | Name of the topic                                     |
| <p><strong>idea\_count</strong><br>number</p> | Number of ideas that have been tagged with this Topic |
| <p><strong>order</strong><br>number</p>       | The position of the topic in the topic list           |

### Endpoints

You can use the following endpoints to manage Topics

#### List topics

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

#### Create a topic

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

#### Update a topic

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

#### Delete a topic

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