Account

List Notifications

get
https://api.linode.com/v4/account/notifications

Returns a collection of Notification objects representing important, often time-sensitive items related to your Account. You cannot interact directly with Notifications, and a Notification will disappear when the circumstances causing it have been resolved. For example, if you have an important Ticket open, you must respond to the Ticket to dismiss the Notification.

Authorizations

Personal Access Token
OAuth: ( account:read_only)

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/account/notifications

Response Samples

{
  "data": [
    {
      "entity": {
        "id": 3456,
        "label": "Linode not booting.",
        "type": "ticket",
        "url": "/support/tickets/3456"
      },
      "label": "You have an important ticket open!",
      "type": "ticket_important",
      "message": "You have an important ticket open!",
      "body": "",
      "severity": "major",
      "when": "",
      "until": ""
    }
  ],
  "page": 1,
  "pages": 1,
  "results": 1
}

Responses

200: Returns a paginated list of Notification objects.

data
array of objects
entity
object

Detailed information about the Notification.

id
integer

The unique ID of the Notification's entity, based on the entity type.

label
string

The current label for this Notification's entity.

type
string

The type of entity this is related to.

url
string

The URL where you can access the object this Notification is for. If a relative URL, it is relative to the domain you retrieved the Notification from.

label
string

A short description of this Notification.

type
string
Enum: "migration_scheduled""migration_imminent""migration_pending""reboot_scheduled""outage""payment_due""ticket_important""ticket_abuse""notice""maintenance""promotion"

The type of Notification this is.

message
string

A human-readable description of the Notification.

body
Nullable
string

A full description of this Notification, in markdown format. Not all Notifications include bodies.

severity
string
Enum: "minor""major""critical"

The severity of this Notification. This field can be used to decide how prominently to display the Notification, what color to make the display text, etc.

when
string

If this Notification is of an Event that will happen at a fixed, future time, this is when the named action will be taken. For example, if a Linode is to be migrated in response to a Security Advisory, this field will contain the approximate time the Linode will be taken offline for migration.

until
string

If this Notification has a duration, this will be the ending time for the Event/action. For example, if there is scheduled maintenance for one of our systems, until would be set to the end of the maintenance window.

page
integer
pages
integer
results
integer

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.