# Comments

## Comment object

Comments have the following fields

| Field                                               | Details                                                                     |
| --------------------------------------------------- | --------------------------------------------------------------------------- |
| <p><strong>idx</strong><br>string</p>               | A unique identifier for the comment                                         |
| <p><strong>message</strong><br>string</p>           | The raw message content of the comment                                      |
| <p><strong>content</strong><br>array</p>            | Structured content as a JSON array (similar to Slate.js/ProseMirror format) |
| <p><strong>content\_html</strong><br>string</p>     | Content rendered as HTML                                                    |
| <p><strong>content\_markdown</strong><br>string</p> | Content rendered as Markdown                                                |
| <p><strong>is\_private</strong><br>boolean</p>      | Indicates if the comment is private (note) or public (comment)              |
| <p><strong>type</strong><br>string</p>              | Type of comment (comment or note)                                           |
| <p><strong>created\_at</strong><br>string</p>       | The date & time the comment was created (UTC timezone)                      |
| <p><strong>updated\_at</strong><br>string</p>       | The date & time the comment was last updated (UTC timezone)                 |
| <p><strong>follower</strong><br>object</p>          | Author of this comment                                                      |
| <p><strong>idea\_id</strong><br>integer</p>         | ID of the associated idea                                                   |
| <p><strong>attachments</strong><br>array</p>        | Files and images attached to this comment                                   |

### Endpoints

You can use the following endpoints to manage Comments

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

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

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

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