Command: update a portal message (admin).

POST

/admin/announcements/{announcementId}/update

curl --request POST \
  --url https://example.com/api/v1/admin/announcements/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/update \
  --header 'Content-Type: application/json' \
  --cookie dnse_session=<dnse_session> \
  --data '{ "title": "example", "body": "example", "severity": "info", "active": true, "startsAt": "2026-04-15T12:00:00Z", "endsAt": "2026-04-15T12:00:00Z" }'

Authorizations

• session

Parameters

Path Parameters

announcementId

required

string format: uuid

Request Body^required

Media typeapplication/json

object

title

required

string

body

string

severity

string

default: info

Allowed values: info warning critical

active

boolean

startsAt

Empty = no lower bound.

string format: date-time

endsAt

Empty = no upper bound.

string format: date-time

Responses

200

Updated announcement.

Media typeapplication/json

Portal message shown as a banner in the user shell.

object

id

string format: uuid

title

string

body

Longer context, shown in a dialog.

string

severity

string

Allowed values: info warning critical

active

boolean

startsAt

string format: date-time

nullable

endsAt

string format: date-time

nullable

updatedAt

string format: date-time

Example

{
  "severity": "info"
}

404

Resource not found.

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}