Account

Account Settings View

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

Returns information related to your Account settings: Managed service subscription, Longview subscription, and network helper.

Request Samples

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

Response Samples

{
  "managed": true,
  "longview_subscription": "longview-3",
  "network_helper": "",
  "backups_enabled": true,
  "object_storage": "active"
}

Responses

200: Returns a single Account settings object.

managed
boolean

Our 24/7 incident response service. This robust, multi-homed monitoring system distributes monitoring checks to ensure that your servers remain online and available at all times. Linode Managed can monitor any service or software stack reachable over TCP or HTTP. Once you add a service to Linode Managed, we'll monitor it for connectivity, response, and total request time.

longview_subscription
string

The Longview Pro tier you are currently subscribed to. The value must be a Longview Subscription ID or null for Longview Free.

network_helper
boolean

Enables network helper across all users by default for new Linodes and Linode Configs.

backups_enabled
boolean

Account-wide backups default. If true, all Linodes created will automatically be enrolled in the Backups service. If false, Linodes will not be enrolled by default, but may still be enrolled on creation or later.

object_storage
string
Enum: "disabled""suspended""active"

A string describing the status of this account's Object Storage service enrollment.

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.

Account Settings Update

put
https://api.linode.com/v4/account/settings

Updates your Account settings.

To update your Longview subscription plan, send a request to Update Longview Plan.

Request Body Schema

backups_enabled
boolean

Account-wide backups default. If true, all Linodes created will automatically be enrolled in the Backups service. If false, Linodes will not be enrolled by default, but may still be enrolled on creation or later.

network_helper
boolean

Enables network helper across all users by default for new Linodes and Linode Configs.

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X PUT -d '{
        "network_helper": true,
    }' \
    https://api.linode.com/v4/account/settings

Response Samples

{
  "managed": true,
  "longview_subscription": "longview-3",
  "network_helper": "",
  "backups_enabled": true,
  "object_storage": "active"
}

Responses

200: The updated Account settings.

managed
boolean

Our 24/7 incident response service. This robust, multi-homed monitoring system distributes monitoring checks to ensure that your servers remain online and available at all times. Linode Managed can monitor any service or software stack reachable over TCP or HTTP. Once you add a service to Linode Managed, we'll monitor it for connectivity, response, and total request time.

longview_subscription
string

The Longview Pro tier you are currently subscribed to. The value must be a Longview Subscription ID or null for Longview Free.

network_helper
boolean

Enables network helper across all users by default for new Linodes and Linode Configs.

backups_enabled
boolean

Account-wide backups default. If true, all Linodes created will automatically be enrolled in the Backups service. If false, Linodes will not be enrolled by default, but may still be enrolled on creation or later.

object_storage
string
Enum: "disabled""suspended""active"

A string describing the status of this account's Object Storage service enrollment.

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.