# Guild announcements

## `GET /api/guilds/{guild_id}/announcements/pending`

**List pending guild announcements**

Returns Discord-queued announcements not yet posted, oldest first. Returns 404 for any guild_id other than the SideQuest server.

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `guild_id` | path | integer | yes | The Discord server ID. Only the SideQuest server works. |

**Response `200` — The pending announcements.**

Model: {ref}`PendingAnnouncementsPage <model-pendingannouncementspage>`

| Field | Type | Required | Description |
|---|---|---|---|
| `items` | array of {ref}`PendingAnnouncement <model-pendingannouncement>` | yes |  |


## `POST /api/guilds/{guild_id}/announcements/{announcement_id}/posted`

**Mark a guild announcement as posted**

Records that an announcement posted to Discord with the given message ID. Returns 404 for any guild_id other than the SideQuest server, or an unknown announcement_id.

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `guild_id` | path | integer | yes | The Discord server ID. Only the SideQuest server works. |
| `announcement_id` | path | string (uuid) | yes | The announcement's ID. |

**Request body**

Model: {ref}`AnnouncementPosted <model-announcementposted>`

| Field | Type | Required | Description |
|---|---|---|---|
| `message_id` | integer | yes |  |

**Response `200` — The announcement's posted state.**

Model: {ref}`AnnouncementPostedResult <model-announcementpostedresult>`

| Field | Type | Required | Description |
|---|---|---|---|
| `message_id` | integer | yes |  |