Create notice

Creates a broadcast notice. Requires Super User or Reseller scope. A Super User may target global, any reseller territory, or any domain. A Reseller may target only their own territory or a domain within their territory, and may never create a global notice. The server mints the notice_uid and sets created_by from your token; both are ignored if sent. The write is published on the internal event bus, so the response is best-effort: the controller waits up to two seconds for the stored row to return and echoes it; if it has not returned, the response echoes the accepted payload instead and the notice is still published. The response status is 200. End users do not receive the notice until the delivery node emits the notification rows.

curl --location '/notices' \ --header 'Content-Type: application/json' \ --data '{ "type": "scheduled_maintenance", "title": "Planned maintenance on Saturday", "message": "The platform will undergo scheduled maintenance on Saturday between 02:00 and 04:00 UTC. Calls may be briefly interrupted.", "link_url": "https://status.example.com/incidents/2026-09-05", "target_type": "domain", "target_value": "acme.example.com", "starts_at": "2026-09-05T02:00:00+00:00", "ends_at": "2026-09-05T04:00:00+00:00", "active": 1 }'

{ "id": 4821, "notice_uid": "7c3a2f14-9b5e-4d21-8f6a-1c2d3e4f5a6b", "type": "scheduled_maintenance", "title": "Planned maintenance on Saturday", "message": "The platform will undergo scheduled maintenance on Saturday between 02:00 and 04:00 UTC. Calls may be briefly interrupted.", "link_url": "https://status.example.com/incidents/2026-09-05", "target_type": "domain", "target_value": "acme.example.com", "active": 1, "created_by": "1001@example.com", "starts_at": "2026-09-05T02:00:00Z", "ends_at": "2026-09-05T04:00:00Z", "created_at": "2026-09-01T14:30:00Z", "updated_at": "2026-09-01T14:30:00Z" }

Request

Responses