> For the complete documentation index, see [llms.txt](https://developers.frill.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.frill.co/api/reference/announcements.md).

# Announcements

## Announcement object

Announcements have the following fields

| Field                                             | Details                                                                                                                 |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <p><strong>idx</strong><br>string</p>             | A unique identifier for the announcement                                                                                |
| <p><strong>name</strong><br>string</p>            | Name of the announcement                                                                                                |
| <p><strong>slug</strong><br>string</p>            | The URL slug of the announcement                                                                                        |
| <p><strong>excerpt</strong><br>string</p>         | Short textual description of the announcement                                                                           |
| <p><strong>content</strong><br>string</p>         | Content of the announcement (as Markdown)                                                                               |
| <p><strong>content\_html</strong><br>string</p>   | Content of the announcement (as HTML)                                                                                   |
| <p><strong>reaction\_count</strong><br>object</p> | Reactions to the announcement                                                                                           |
| <p><strong>is\_published</strong><br>boolean</p>  | Indicates if the announcement is published or not                                                                       |
| <p><strong>published\_at</strong><br>string</p>   | The date & time the announcement was published (UTC timezone) or null if still in draft                                 |
| <p><strong>created\_at</strong><br>string</p>     | The date & time the announcement was created (UTC timezone)                                                             |
| <p><strong>updated\_at</strong><br>string</p>     | The date & time the announcement was last updated (UTC timezone)                                                        |
| <p><strong>author</strong><br>object</p>          | Author of this announcement                                                                                             |
| <p><strong>categories</strong><br>array</p>       | Categories associated with this announcement (see [Announcement Categories](/api/reference/announcement-categories.md)) |
| <p><strong>ideas</strong><br>array</p>            | Ideas associated with this announcement                                                                                 |

### Endpoints

You can use the following endpoints to manage Announcements

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

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

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

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

{% openapi src="/files/3IeSmtlpFc9gA6fdUfCf" path="/announcements/{announcementIdx}" method="delete" %}
[announcements.yaml](https://554427104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIpllvC2FiBlBNS7dyV5t%2Fuploads%2Fgit-blob-9024ffb00fe407223ecddfe3e27bf3f8da05cb0c%2Fannouncements.yaml?alt=media)
{% endopenapi %}