Platform Notifications
Announcements from the ngris team that apply to the caller right now: maintenance windows, incidents and other notices. The dashboard shows the same list as a banner at the top of every page.
A notification is returned while it is active and inside its optional schedule (starts_at / ends_at), when it is addressed to everyone, to the calling user, or to the caller's organization. The most severe come first (error, then warning, then info), newest first within a severity. At most 5 are returned.
Response (200 OK)
notifications array
Empty when there is nothing to show.
notifications[].uuid string (uuid)
Stable public id. Use it to remember which ones the user has dismissed.
notifications[].type string
banner, notification or alert.notifications[].severity string
error, warning or info.notifications[].title string
Plain text. Render it as text, not HTML.
notifications[].message string
Plain text, may be empty.
notifications[].starts_at / ends_at datetime
RFC 3339 UTC. Present only when the notification is scheduled.
Deprecated: until the sunset each notification also carries the legacy integer id. Key dismissals on uuid instead.
Errors
401 Unauthorized
Missing auth.
500
Database error.
Request
curl "https://api.ngris.com/v1/platform-notifications" \
-H "X-API-KEY: <your_api_key>"
Response — 200 OK
{
"notifications": [
{
"uuid": "019aa86f-83e3-7672-b248-dd4b5083da7a",
"type": "banner",
"severity": "warning",
"title": "Scheduled maintenance",
"message": "Sunday 02:00–03:00 UTC: dashboard sign-in may be briefly unavailable.",
"starts_at": "2026-10-03T00:00:00Z",
"ends_at": "2026-10-05T03:00:00Z"
}
]
}