Get account settings

get

https://api.linode.com/{apiVersion}/account/settings

Returns information related to your Account settings: Managed service subscription, interface settings for new Linodes, Longview subscription, and Network Helper.

Permissions and scopes

To call this operation, you need the following:

Identity and access permissions. Your user needs a role with these permissions assigned. Learn more.
- Permissions: view_account_settings
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: account:read_only

CLI

linode-cli account settings

Learn more

Responses

Response body

object

Account Settings object.

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.

interfaces_for_new_linodes

string

enum

Defines if new Linodes can use legacy configuration interfaces:

legacy_config_only. All new Linodes need to use legacy configuration interfaces. Previously created Linodes with Linode Interfaces can still exist. Linodes using legacy configuration interfaces can't be upgraded to use Linode Interfaces.
legacy_config_default_but_linode_allowed. New Linodes can use legacy configuration interfaces or Linode Interfaces, depending on the interface_generation setting specified when creating the Linode. By default, new Linodes use legacy configuration interfaces unless otherwise specified. Linodes that use legacy configuration interfaces can upgrade to Linode Interfaces. This is the default setting for existing accounts.
linode_default_but_legacy_config_allowed. New Linodes can use legacy configuration interfaces or Linode Interfaces, depending on the interface_generation setting specified when creating the Linode. By default, new Linodes use Linode Interfaces unless otherwise specified. Linodes that use legacy configuration interfaces can upgrade to Linode interfaces. This is the default setting for new accounts.
linode_only. All new Linodes need to use Linode Interfaces. Previously created Linodes with legacy configuration profile interfaces can still exist if they were created under a previous setting. Linodes using legacy configuration interfaces can be upgraded to Linode Interfaces.

legacy_config_only legacy_config_default_but_linode_allowed linode_default_but_legacy_config_allowed linode_only

longview_subscription

string

Read-only The Longview Pro tier you are currently subscribed to. The value must be a Longview subscription ID or null for Longview Free.

maintenance_policy

string

enum

Defines the default maintenance policy for new Linodes created on this account. Review maintenance policy documentation for more details.

linode/migrate linode/power_off_on

managed

boolean

Read-only 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.

network_helper

boolean

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

object_storage

string

enum

Defaults to disabled

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

disabled suspended active

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.linode.com/v4/account/settings \
3
     --header 'accept: application/json'


xxxxxxxxxx
 
1
{
2
  "backups_enabled": true,
3
  "interfaces_for_new_linodes": "linode_only",
4
  "longview_subscription": "longview-3",
5
  "maintenance_policy": "linode/migrate",
6
  "managed": true,
7
  "network_helper": false,
8
  "object_storage": "active"
9
}

200Returns a single Account settings object.

defaultSee Errors for the range of possible error response codes.