---
title: "Create Announcement"
method: POST
path: "/api/admin/announcements"
tags: ["Announcements (Admin)"]
---

# Create Announcement

`POST /api/admin/announcements`

## Request

- Base URL: `https://api.soeru.biz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.soeru.biz/api/admin/announcements`
- Auth: none declared. Required headers: `authorization`

Create a new draft announcement.

## Headers

- `authorization` string, required: Bearer <token>

## Request body

- CreateAnnouncementRequest
  - `slug` string, required
  - `title` string, required
  - `body_md` string, required
  - `severity` 'info' | 'warning' | 'critical'
  - `audience` 'admin_only' | 'public_only' | 'both'
  - `starts_at` string, date-time, nullable
  - `ends_at` string, date-time, nullable
  - `incident_id` string, nullable
  - `related_links` RelatedLink[]
    - `label` string, required
    - `url` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/soeru/apis/soeru-api.md) · [All operations](https://skmtc.dev/soeru/apis/soeru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soeru/apis/soeru-api/revisions/63f8d371abed?raw)