Update Advisory

Update Advisory

Updates an advisory for the active session using a specified id. Advisories that have a MANDATORY priority may not be updated.

Request
URI
PUT
https://{api_host}/cloudapi/1.0.0/advisories/{advisoryId}
COPY
Path Parameters
string
advisoryId
Required

advisory URN

string
advisoryId
Required

advisory URN


Request Body
Advisory of type(s) application/json
Required
{
    "id": "string",
    "targetId": "string",
    "message": "string",
    "priority": "string",
    "displayStart": "string",
    "displayEnd": "string",
    "source": "string"
}
string
id
Optional

A unique identifier for the advisory (read-only).

string
targetId
Optional

The id reference to the target entity this advisory is for.

string
message
Optional

A localized message for this advisory.

string
priority
Optional

Priority for an advisory that indicates the level of urgency. These priorities are listed in ascending sort order.

  • MANDATORY: A mandatory message which is always displayed; these advisories cannot be snoozed or dismissed (see documentation on displayStart and displayEnd)
  • CRITICAL: A high priority, potentially actionable message which can be snoozed or dismissed
  • IMPORTANT: A potentially actionable message which can be snoozed or dismissed
  • NOTICE: An informational message which can be dismissed (but not snoozed)
string As date-time As date-time
displayStart
Optional

The ISO-8601 timestamp from which this advisory is applicable. Defaults to the server's current time if unspecified. If permissible, users may update this value to a time in the future to snooze this advisory.

string As date-time As date-time
displayEnd
Optional

The ISO-8601 timestamp representing when this advisory is no longer applicable. If permissible, users may update this value to a time in the past to dismiss this advisory. The displayEnd timestamp must be >= displayStart.

string
source
Optional

Represents where the advisory is being generated from. This is a read-only field. Can be of type USER or INTERNAL.

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns Advisory of type(s) application/json;version=36.3
{
    "id": "string",
    "targetId": "string",
    "message": "string",
    "priority": "string",
    "displayStart": "string",
    "displayEnd": "string",
    "source": "string"
}
string
id
Optional

A unique identifier for the advisory (read-only).

string
targetId
Optional

The id reference to the target entity this advisory is for.

string
message
Optional

A localized message for this advisory.

string
priority
Optional

Priority for an advisory that indicates the level of urgency. These priorities are listed in ascending sort order.

  • MANDATORY: A mandatory message which is always displayed; these advisories cannot be snoozed or dismissed (see documentation on displayStart and displayEnd)
  • CRITICAL: A high priority, potentially actionable message which can be snoozed or dismissed
  • IMPORTANT: A potentially actionable message which can be snoozed or dismissed
  • NOTICE: An informational message which can be dismissed (but not snoozed)
string As date-time As date-time
displayStart
Optional

The ISO-8601 timestamp from which this advisory is applicable. Defaults to the server's current time if unspecified. If permissible, users may update this value to a time in the future to snooze this advisory.

string As date-time As date-time
displayEnd
Optional

The ISO-8601 timestamp representing when this advisory is no longer applicable. If permissible, users may update this value to a time in the past to dismiss this advisory. The displayEnd timestamp must be >= displayStart.

string
source
Optional

Represents where the advisory is being generated from. This is a read-only field. Can be of type USER or INTERNAL.