Skip to main content
POST
Create an announcement

Authorizations

Authorization
string
header
required

Body

application/json

Announcement request body

Create announcement request body

isDismissible
boolean
required

true if the announcement is dismissible

Example:

true

title
string
required

The title of the announcement

Example:

"System Maintenance Notice"

message
string
required

The message of the announcement

Example:

"**Important Update:**\n\nPlease be aware of the upcoming maintenance scheduled for *October 31st, 2024*. The system will be unavailable from **12:00 AM** to **4:00 AM**."

startTime
integer<int64>
required

The start time of the announcement. This is a Unix timestamp in milliseconds.

Example:

1731439812

severity
enum<string>
required

The severity of the announcement

Available options:
info,
warning,
critical
Example:

"warning"

endTime
integer<int64>

The end time of the announcement. This is a Unix timestamp in milliseconds.

Example:

1731439880

Response

Created announcement

Announcement response

_id
string
required

The ID of the announcement

Example:

"1234567890"

isDismissible
boolean
required

true if the announcement is dismissible

Example:

true

title
string
required

The title of the announcement

Example:

"System Maintenance Notice"

message
string
required

The message of the announcement

Example:

"**Important Update:**\n\nPlease be aware of the upcoming maintenance scheduled for *October 31st, 2024*. The system will be unavailable from **12:00 AM** to **4:00 AM**."

startTime
integer<int64>
required

The start time of the announcement. This is a Unix timestamp in milliseconds.

Example:

1731439812

severity
enum<string>
required

The severity of the announcement

Available options:
info,
warning,
critical
_status
enum<string>
required

The status of the announcement

Available options:
active,
inactive,
scheduled
Example:
endTime
integer<int64>

The end time of the announcement. This is a Unix timestamp in milliseconds.

Example:

1731439880

_access
object
Example: