Account v4.166.0

Account View

GET https://api.linode.com/v4/account

Returns the contact and billing information related to your Account.

Authorizations

personalAccessToken
oauthaccount:read_only

Request Samples

Response Samples

Responses

Account Update

PUT https://api.linode.com/v4/account

Updates contact and billing information related to your Account.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

address_1
string <= 64 characters

First line of this Account’s billing address.

address_2
string <= 64 characters

Second line of this Account’s billing address.

city
string <= 24 characters

The city for this Account’s billing address.

company
string <= 128 characters

The company name associated with this Account.

Must not include any of the following characters: < > ( ) " =

country
string

The two-letter ISO 3166 country code of this Account’s billing address.

email
string <= 128 characters

The email address of the person associated with this Account.

first_name
string <= 50 characters

The first name of the person associated with this Account.

Must not include any of the following characters: < > ( ) " =

last_name
string <= 50 characters

The last name of the person associated with this Account.

Must not include any of the following characters: < > ( ) " =

phone
string <= 32 characters

The phone number associated with this Account.

state
string <= 24 characters

If billing address is in the United States (US) or Canada (CA), only the two-letter ISO 3166 State or Province code are accepted. If entering a US military address, state abbreviations (AA, AE, AP) should be entered. If the address is outside the US or CA, this is the Province associated with the Account’s billing address.

tax_id
string <= 25 characters

The tax identification number associated with this Account, for tax calculations in some countries. If you do not live in a country that collects tax, this should be an empty string ("").

zip
string

The zip code of this Account’s billing address. The following restrictions apply:

  • May only consist of letters, numbers, spaces, and hyphens.
  • Must not contain more than 9 letter or number characters.

Response Samples

Responses

Account Cancel

POST https://api.linode.com/v4/account/cancel

Cancels an active Linode account. This action will cause Linode to attempt to charge the credit card on file for the remaining balance. An error will occur if Linode fails to charge the credit card on file. Restricted users will not be able to cancel an account.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

comments
string

Any reason for cancelling the account, and any other comments you might have about your Linode service.

Response Samples

Responses

Credit Card Add/Edit

POST https://api.linode.com/v4/account/credit-card

DEPRECATED. Please use Payment Method Add ( POST /account/payment-methods).

Adds a credit card Payment Method to your account and sets it as the default method.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

card_number
Required
string<digits> 14..24 characters

Your credit card number. No spaces or dashes allowed.

cvv
Required
string<digits> 3..4 characters

CVV (Card Verification Value) of the credit card, typically found on the back of the card.

expiry_month
Required
integer 1..12

A value from 1-12 representing the expiration month of your credit card.

  • 1 = January
  • 2 = February
  • 3 = March
  • Etc.

expiry_year
Required
integer 4..4 characters

A four-digit integer representing the expiration year of your credit card.

The combination of expiry_month and expiry_year must result in a month/year combination of the current month or in the future. An expiration date set in the past is invalid.

Response Samples

Responses

Entity Transfers List

GET https://api.linode.com/v4/account/entity-transfers

DEPRECATED. Please use Service Transfers List.

Authorizations

personalAccessToken
oauthaccount:read_only

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

Entity Transfer Create

POST https://api.linode.com/v4/account/entity-transfers

DEPRECATED. Please use Service Transfer Create.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

entities
Required
object

A collection of the entities to include in this transfer request, separated by type.

linodes
array of integers

An array containing the IDs of each of the Linodes included in this transfer.

Response Samples

Responses

Entity Transfer Cancel

DELETE https://api.linode.com/v4/account/entity-transfers/{token}

DEPRECATED. Please use Service Transfer Cancel.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

tokenstring<uuid>
Required

The UUID of the Entity Transfer.

Request Samples

Response Samples

Responses

Entity Transfer View

GET https://api.linode.com/v4/account/entity-transfers/{token}

DEPRECATED. Please use Service Transfer View.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

tokenstring<uuid>
Required

The UUID of the Entity Transfer.

Request Samples

Response Samples

Responses

Entity Transfer Accept

POST https://api.linode.com/v4/account/entity-transfers/{token}/accept

DEPRECATED. Please use Service Transfer Accept.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

tokenstring<uuid>
Required

The UUID of the Entity Transfer.

Request Samples

Response Samples

Responses

Events List

GET https://api.linode.com/v4/account/events

Returns a collection of Event objects representing actions taken on your Account from the last 90 days. The Events returned depend on your grants.

Authorizations

personalAccessToken
oauthevents:read_only

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

Event View

GET https://api.linode.com/v4/account/events/{eventId}

Returns a single Event object.

Authorizations

personalAccessToken
oauthevents:read_only

Path Parameters

eventIdinteger
Required

The ID of the Event.

Request Samples

Response Samples

Responses

Event Mark as Read

POST https://api.linode.com/v4/account/events/{eventId}/read

Marks a single Event as read.

Authorizations

personalAccessToken
oauthevents:read_only

Path Parameters

eventIdinteger
Required

The ID of the Event to designate as read.

Request Samples

Response Samples

Responses

Event Mark as Seen

POST https://api.linode.com/v4/account/events/{eventId}/seen

Marks all Events up to and including this Event by ID as seen.

Authorizations

personalAccessToken
oauthevents:read_only

Path Parameters

eventIdinteger
Required

The ID of the Event to designate as seen.

Request Samples

Response Samples

Responses

Invoices List

GET https://api.linode.com/v4/account/invoices

Returns a paginated list of Invoices against your Account.

Authorizations

personalAccessToken
oauthaccount:read_only

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

Invoice View

GET https://api.linode.com/v4/account/invoices/{invoiceId}

Returns a single Invoice object.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

invoiceIdinteger
Required

The ID of the Invoice.

Request Samples

Response Samples

Responses

Invoice Items List

GET https://api.linode.com/v4/account/invoices/{invoiceId}/items

Returns a paginated list of Invoice items.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

invoiceIdinteger
Required

The ID of the Invoice.

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

User Logins List All

GET https://api.linode.com/v4/account/logins

Returns a collection of successful logins for all users on the account during the last 90 days. This command can only be accessed by the unrestricted users of an account.

Authorizations

personalAccessToken
oauthaccount:read_only

Request Samples

Response Samples

Responses

Login View

GET https://api.linode.com/v4/account/logins/{loginId}

Returns a Login object that displays information about a successful login. The logins that can be viewed can be for any user on the account, and are not limited to only the logins of the user that is accessing this API endpoint. This command can only be accessed by the unrestricted users of the account.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

loginIdinteger
Required

The ID of the login object to access.

Request Samples

Response Samples

Responses

Maintenance List

GET https://api.linode.com/v4/account/maintenance

Returns a collection of Maintenance objects for any entity a user has permissions to view. Canceled Maintenance objects are not returned.

Currently, Linodes are the only entities available for viewing.

Authorizations

personalAccessToken
oauth

Request Samples

Response Samples

Responses

Notifications List

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

personalAccessToken
oauthaccount:read_only

Request Samples

Response Samples

Responses

OAuth Clients List

GET https://api.linode.com/v4/account/oauth-clients

Returns a paginated list of OAuth Clients registered to your Account. OAuth Clients allow users to log into applications you write or host using their Linode Account, and may allow them to grant some level of access to their Linodes or other entities to your application.

Authorizations

personalAccessToken
oauthaccount:read_only

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

OAuth Client Create

POST https://api.linode.com/v4/account/oauth-clients

Creates an OAuth Client, which can be used to allow users (using their Linode account) to log in to your own application, and optionally grant your application some amount of access to their Linodes or other entities.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

label
Required
string 1..512 characters

The name of this application. This will be presented to users when they are asked to grant it access to their Account.

public
boolean
Default: false

If this is a public or private OAuth Client. Public clients have a slightly different authentication workflow than private clients. See the OAuth spec for more details.

redirect_uri
Required
string<url>

The location a successful log in from https://login.linode.com should be redirected to for this client. The receiver of this redirect should be ready to accept an OAuth exchange code and finish the OAuth exchange.

Response Samples

Responses

OAuth Client Delete

DELETE https://api.linode.com/v4/account/oauth-clients/{clientId}

Deletes an OAuth Client registered with Linode. The Client ID and Client secret will no longer be accepted by https://login.linode.com, and all tokens issued to this client will be invalidated (meaning that if your application was using a token, it will no longer work).

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

clientIdstring
Required

The OAuth Client ID to look up.

Request Samples

Response Samples

Responses

OAuth Client View

GET https://api.linode.com/v4/account/oauth-clients/{clientId}

Returns information about a single OAuth client.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

clientIdstring
Required

The OAuth Client ID to look up.

Request Samples

Response Samples

Responses

OAuth Client Update

PUT https://api.linode.com/v4/account/oauth-clients/{clientId}

Update information about an OAuth Client on your Account. This can be especially useful to update the redirect_uri of your client in the event that the callback url changed in your application.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

clientIdstring
Required

The OAuth Client ID to look up.

Request Samples

Request Body Schema

label
string 1..512 characters

The name of this application. This will be presented to users when they are asked to grant it access to their Account.

public
boolean
Default: false

If this is a public or private OAuth Client. Public clients have a slightly different authentication workflow than private clients. See the OAuth spec for more details.

redirect_uri
string<url>

The location a successful log in from https://login.linode.com should be redirected to for this client. The receiver of this redirect should be ready to accept an OAuth exchange code and finish the OAuth exchange.

Response Samples

Responses

OAuth Client Secret Reset

POST https://api.linode.com/v4/account/oauth-clients/{clientId}/reset-secret

Resets the OAuth Client secret for a client you own, and returns the OAuth Client with the plaintext secret. This secret is not supposed to be publicly known or disclosed anywhere. This can be used to generate a new secret in case the one you have has been leaked, or to get a new secret if you lost the original. The old secret is expired immediately, and logins to your client with the old secret will fail.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

clientIdstring
Required

The OAuth Client ID to look up.

Request Samples

Response Samples

Responses

OAuth Client Thumbnail View

GET https://api.linode.com/v4/account/oauth-clients/{clientId}/thumbnail

Returns the thumbnail for this OAuth Client. This is a publicly-viewable endpoint, and can be accessed without authentication.

Authorizations

Path Parameters

clientIdstring
Required

The OAuth Client ID to look up.

Request Samples

Response Samples

Responses

OAuth Client Thumbnail Update

PUT https://api.linode.com/v4/account/oauth-clients/{clientId}/thumbnail

Upload a thumbnail for a client you own. You must upload an image file that will be returned when the thumbnail is retrieved. This image will be publicly-viewable.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

clientIdstring
Required

The OAuth Client ID to look up.

Request Samples

Response Samples

Responses

Payment Methods List

GET https://api.linode.com/v4/account/payment-methods

Returns a paginated list of Payment Methods for this Account.

Authorizations

personalAccessToken
oauthaccount:read_only

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

Payment Method Add

POST https://api.linode.com/v4/account/payment-methods

Adds a Payment Method to your Account with the option to set it as the default method.

  • Adding a default Payment Method removes the default status from any other Payment Method.

  • An Account can have up to 6 active Payment Methods.

  • Up to 60 Payment Methods can be added each day.

  • Prior to adding a Payment Method, ensure that your billing address information is up-to-date with a valid zip by using the Account Update ( PUT /account) endpoint.

  • A payment_method_add event is generated when a payment is successfully submitted.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

data
Required
object

An object representing the credit card information you have on file with Linode to make Payments against your Account.

card_number
Required
string<digits> 14..24 characters

Your credit card number. No spaces or dashes allowed.

cvv
Required
string<digits> 3..4 characters

CVV (Card Verification Value) of the credit card, typically found on the back of the card.

expiry_month
Required
integer 1..12

A value from 1-12 representing the expiration month of your credit card.

  • 1 = January
  • 2 = February
  • 3 = March
  • Etc.

expiry_year
Required
integer 4..4 characters

A four-digit integer representing the expiration year of your credit card.

The combination of expiry_month and expiry_year must result in a month/year combination of the current month or in the future. An expiration date set in the past is invalid.

is_default
Required
boolean

Whether this Payment Method is the default method for automatically processing service charges.

type
Required
string
Enum: credit_card

The type of Payment Method.

Alternative Payment Methods including Google Pay and PayPal can be added using the Cloud Manager. See the Manage Payment Methods guide for details and instructions.

Response Samples

Responses

Payment Method Delete

DELETE https://api.linode.com/v4/account/payment-methods/{paymentMethodId}

Deactivate the specified Payment Method.

The default Payment Method can not be deleted. To add a new default Payment Method, access the Payment Method Add ( POST /account/payment-methods) endpoint. To designate an existing Payment Method as the default method, access the Payment Method Make Default ( POST /account/payment-methods/{paymentMethodId}/make-default) endpoint.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

paymentMethodIdinteger
Required

The ID of the Payment Method to look up.

Request Samples

Response Samples

Responses

Payment Method View

GET https://api.linode.com/v4/account/payment-methods/{paymentMethodId}

View the details of the specified Payment Method.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

paymentMethodIdinteger
Required

The ID of the Payment Method to look up.

Request Samples

Response Samples

Responses

Payment Method Make Default

POST https://api.linode.com/v4/account/payment-methods/{paymentMethodId}/make-default

Make the specified Payment Method the default method for automatically processing payments.

Removes the default status from any other Payment Method.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

paymentMethodIdinteger
Required

The ID of the Payment Method to make default.

Request Samples

Response Samples

Responses

Payments List

GET https://api.linode.com/v4/account/payments

Returns a paginated list of Payments made on this Account.

Authorizations

personalAccessToken
oauthaccount:read_only

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

Payment Make

POST https://api.linode.com/v4/account/payments

Makes a Payment to your Account.

  • The requested amount is charged to the default Payment Method if no payment_method_id is specified.

  • A payment_submitted event is generated when a payment is successfully submitted.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

cvv
string

CVV (Card Verification Value) of the credit card to be used for the Payment. Required if paying by credit card.

payment_method_id
integer

The ID of the Payment Method to apply to the Payment.

usd
Required
string

The amount in US Dollars of the Payment.

  • Can begin with or without $.
  • Commas (,) are not accepted.
  • Must end with a decimal expression, such as .00 or .99.
  • Minimum: $5.00 or the Account balance, whichever is lower.
  • Maximum: $2000.00 or the Account balance up to $50000.00, whichever is greater.

Response Samples

Responses

PayPal Payment Stage

POST https://api.linode.com/v4/account/payments/paypal

Note: This endpoint is disabled and no longer accessible. PayPal can be designated as a Payment Method for automated payments using the Cloud Manager. See Manage Payment Methods.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

cancel_url
Required
string

The URL to have PayPal redirect to when Payment is canceled.

redirect_url
Required
string

The URL to have PayPal redirect to when Payment is approved.

usd
Required
string

The payment amount in USD. Minimum accepted value of $5 USD. Maximum accepted value of $500 USD or credit card payment limit; whichever value is highest. PayPal’s maximum transaction limit is $10,000 USD.

Response Samples

Responses

Staged/Approved PayPal Payment Execute

POST https://api.linode.com/v4/account/payments/paypal/execute

Note: This endpoint is disabled and no longer accessible. PayPal can be designated as a Payment Method for automated payments using the Cloud Manager. See Manage Payment Methods.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

payer_id
Required
string

The PayerID returned by PayPal during the transaction authorization process.

payment_id
Required
string

The PaymentID returned from POST /account/payments/paypal that has been approved with PayPal.

Response Samples

Responses

Payment View

GET https://api.linode.com/v4/account/payments/{paymentId}

Returns information about a specific Payment.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

paymentIdinteger
Required

The ID of the Payment to look up.

Request Samples

Response Samples

Responses

Promo Credit Add

POST https://api.linode.com/v4/account/promo-codes

Adds an expiring Promo Credit to your account.

The following restrictions apply:

  • Your account must be less than 90 days old.
  • There must not be an existing Promo Credit already on your account.
  • The requesting User must be unrestricted. Use the User Update ( PUT /account/users/{username}) to change a User’s restricted status.
  • The promo_code must be valid and unexpired.

Authorizations

personalAccessToken
oauthaccount:read_only

Request Samples

Request Body Schema

promo_code
Required
string 1..32 characters

The Promo Code.

Response Samples

Responses

Service Transfers List

GET https://api.linode.com/v4/account/service-transfers

Returns a collection of all created and accepted Service Transfers for this account, regardless of the user that created or accepted the transfer.

This command can only be accessed by the unrestricted users of an account.

Authorizations

personalAccessToken
oauthaccount:read_only

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

Service Transfer Create

POST https://api.linode.com/v4/account/service-transfers

Creates a transfer request for the specified services. A request can contain any of the specified service types and any number of each service type. At this time, only Linodes can be transferred.

When created successfully, a confirmation email is sent to the account that created this transfer containing a transfer token and instructions on completing the transfer.

When a transfer is accepted, the requested services are moved to the receiving account. Linode services will not experience interruptions due to the transfer process. Backups for Linodes are transferred as well.

DNS records that are associated with requested services will not be transferred or updated. Please ensure that associated DNS records have been updated or communicated to the recipient prior to the transfer.

A transfer can take up to three hours to complete once accepted. When a transfer is completed, billing for transferred services ends for the sending account and begins for the receiving account.

This command can only be accessed by the unrestricted users of an account.

There are several conditions that must be met in order to successfully create a transfer request:

  1. The account creating the transfer must not have a past due balance or active Terms of Service violation.

  2. The service must be owned by the account that is creating the transfer.

  3. The service must not be assigned to another Service Transfer that is pending or that has been accepted and is incomplete.

  4. Linodes must not:

    • be assigned to a NodeBalancer, Firewall, VLAN, or Managed Service.

    • have any attached Block Storage Volumes.

    • have any shared IP addresses.

    • have any assigned /56, /64, or /116 IPv6 ranges.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

entities
Required
object

A collection of the services to include in this transfer request, separated by type.

linodes
array of integers

An array containing the IDs of each of the Linodes included in this transfer.

Response Samples

Responses

Service Transfer Cancel

DELETE https://api.linode.com/v4/account/service-transfers/{token}

Cancels the Service Transfer for the provided token. Once canceled, a transfer cannot be accepted or otherwise acted on in any way. If canceled in error, the transfer must be created again.

When canceled, an email notification for the cancellation is sent to the account that created this transfer. Transfers can not be canceled if they are expired or have been accepted.

This command can only be accessed by the unrestricted users of the account that created this transfer.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

tokenstring<uuid>
Required

The UUID of the Service Transfer.

Request Samples

Response Samples

Responses

Service Transfer View

GET https://api.linode.com/v4/account/service-transfers/{token}

Returns the details of the Service Transfer for the provided token.

While a transfer is pending, any unrestricted user of any account can access this command. After a transfer has been accepted, it can only be viewed by unrestricted users of the accounts that created and accepted the transfer. If canceled or expired, only unrestricted users of the account that created the transfer can view it.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

tokenstring<uuid>
Required

The UUID of the Service Transfer.

Request Samples

Response Samples

Responses

Service Transfer Accept

POST https://api.linode.com/v4/account/service-transfers/{token}/accept

Accept a Service Transfer for the provided token to receive the services included in the transfer to your account. At this time, only Linodes can be transferred.

When accepted, email confirmations are sent to the accounts that created and accepted the transfer. A transfer can take up to three hours to complete once accepted. Once a transfer is completed, billing for transferred services ends for the sending account and begins for the receiving account.

This command can only be accessed by the unrestricted users of the account that receives the transfer. Users of the same account that created a transfer cannot accept the transfer.

There are several conditions that must be met in order to accept a transfer request:

  1. Only transfers with a pending status can be accepted.

  2. The account accepting the transfer must have a registered payment method and must not have a past due balance or other account limitations for the services to be transferred.

  3. Both the account that created the transfer and the account that is accepting the transfer must not have any active Terms of Service violations.

  4. The service must still be owned by the account that created the transfer.

  5. Linodes must not:

    • be assigned to a NodeBalancer, Firewall, VLAN, or Managed Service.

    • have any attached Block Storage Volumes.

    • have any shared IP addresses.

    • have any assigned /56, /64, or /116 IPv6 ranges.

Any and all of the above conditions must be cured and maintained by the relevant account prior to the transfer’s expiration to allow the transfer to be accepted by the receiving account.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

tokenstring<uuid>
Required

The UUID of the Service Transfer.

Request Samples

Response Samples

Responses

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.

Authorizations

personalAccessToken
oauthaccount:read_only

Request Samples

Response Samples

Responses

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.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

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.

Response Samples

Responses

Linode Managed Enable

POST https://api.linode.com/v4/account/settings/managed-enable

Enables Linode Managed for the entire account and sends a welcome email to the account’s associated email address. Linode Managed can monitor any service or software stack reachable over TCP or HTTP. See our Linode Managed guide to learn more.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Response Samples

Responses

Network Utilization View

GET https://api.linode.com/v4/account/transfer

Returns a Transfer object showing your network utilization, in GB, for the current month.

Authorizations

personalAccessToken
oauthaccount:read_only

Request Samples

Response Samples

Responses

Users List

GET https://api.linode.com/v4/account/users

Returns a paginated list of Users on your Account.

This command can only be accessed by the unrestricted users of an account.

Users may access all or part of your Account based on their restricted status and grants. An unrestricted User may access everything on the account, whereas restricted User may only access entities or perform actions they’ve been given specific grants to.

Authorizations

personalAccessToken
oauthaccount:read_only

Query Parameters

page
Type:
integer >= 1
Default: 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..500
Default: 100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

User Create

POST https://api.linode.com/v4/account/users

Creates a User on your Account. Once created, a confirmation message containing password creation and login instructions is sent to the User’s email address.

This command can only be accessed by the unrestricted users of an account.

The User’s account access is determined by whether or not they are restricted, and what grants they have been given.

Authorizations

personalAccessToken
oauthaccount:read_write

Request Samples

Request Body Schema

email
Required
string<email>

The email address for the User. Linode sends emails to this address for account management communications. May be used for other communications as configured.

restricted
boolean

If true, the User must be granted access to perform actions or access entities on this Account. See User Grants View ( GET /account/users/{username}/grants) for details on how to configure grants for a restricted User.

username
Required
string 3..32 characters

The User’s username. This is used for logging in, and may also be displayed alongside actions the User performs (for example, in Events or public StackScripts).

Response Samples

Responses

User Delete

DELETE https://api.linode.com/v4/account/users/{username}

Deletes a User. The deleted User will be immediately logged out and may no longer log in or perform any actions. All of the User’s Grants will be removed.

This command can only be accessed by the unrestricted users of an account.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

usernamestring
Required

The username to look up.

Request Samples

Response Samples

Responses

User View

GET https://api.linode.com/v4/account/users/{username}

Returns information about a single User on your Account.

This command can only be accessed by the unrestricted users of an account.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

usernamestring
Required

The username to look up.

Request Samples

Response Samples

Responses

User Update

PUT https://api.linode.com/v4/account/users/{username}

Update information about a User on your Account. This can be used to change the restricted status of a User. When making a User restricted, no grants will be configured by default and you must then set up grants in order for the User to access anything on the Account.

This command can only be accessed by the unrestricted users of an account.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

usernamestring
Required

The username to look up.

Request Samples

Request Body Schema

email
string<email>

The email address for the User. Linode sends emails to this address for account management communications. May be used for other communications as configured.

restricted
boolean

If true, the User must be granted access to perform actions or access entities on this Account. See User Grants View ( GET /account/users/{username}/grants) for details on how to configure grants for a restricted User.

username
string 3..32 characters

The User’s username. This is used for logging in, and may also be displayed alongside actions the User performs (for example, in Events or public StackScripts).

Response Samples

Responses

User's Grants View

GET https://api.linode.com/v4/account/users/{username}/grants

Returns the full grants structure for the specified account User (other than the account owner, see below for details). This includes all entities on the Account alongside the level of access this User has to each of them.

This command can only be accessed by the unrestricted users of an account.

The current authenticated User, including the account owner, may view their own grants at the /profile/grants endpoint, but will not see entities that they do not have access to.

Authorizations

personalAccessToken
oauthaccount:read_only

Path Parameters

usernamestring
Required

The username to look up.

Request Samples

Response Samples

Responses

User's Grants Update

PUT https://api.linode.com/v4/account/users/{username}/grants

Update the grants a User has. This can be used to give a User access to new entities or actions, or take access away. You do not need to include the grant for every entity on the Account in this request; any that are not included will remain unchanged.

This command can only be accessed by the unrestricted users of an account.

Authorizations

personalAccessToken
oauthaccount:read_write

Path Parameters

usernamestring
Required

The username to look up.

Request Samples

Request Body Schema

database
array of objects

The grants this User has for each Database that is owned by this Account.

id
integer

The ID of the entity this grant applies to.

permissions
Nullable
string
Enum: read_only read_write

The level of access this User has to this entity. If null, this User has no access.

domain
array of objects

The grants this User has for each Domain that is owned by this Account.

id
integer

The ID of the entity this grant applies to.

permissions
Nullable
string
Enum: read_only read_write

The level of access this User has to this entity. If null, this User has no access.

global
object

A structure containing the Account-level grants a User has.

account_access
Nullable
string
Enum: read_only read_write

The level of access this User has to Account-level actions, like billing information. A restricted User will never be able to manage users.

add_databases
boolean

if true, this User may add Managed Databases.

add_domains
boolean

If true, this User may add Domains.

add_firewalls
boolean

If true, this User may add Firewalls.

add_images
boolean

If true, this User may add Images.

add_linodes
boolean

If true, this User may create Linodes.

add_longview
boolean

If true, this User may create Longview clients and view the current plan.

add_nodebalancers
boolean

If true, this User may add NodeBalancers.

add_stackscripts
boolean

If true, this User may add StackScripts.

add_volumes
boolean

If true, this User may add Volumes.

cancel_account
boolean

If true, this User may cancel the entire Account.

longview_subscription
boolean

If true, this User may manage the Account’s Longview subscription.

image
array of objects

The grants this User has for each Image that is owned by this Account.

id
integer

The ID of the entity this grant applies to.

permissions
Nullable
string
Enum: read_only read_write

The level of access this User has to this entity. If null, this User has no access.

linode
array of objects

The grants this User has for each Linode that is owned by this Account.

id
integer

The ID of the entity this grant applies to.

permissions
Nullable
string
Enum: read_only read_write

The level of access this User has to this entity. If null, this User has no access.

longview
array of objects

The grants this User has for each Longview Client that is owned by this Account.

id
integer

The ID of the entity this grant applies to.

permissions
Nullable
string
Enum: read_only read_write

The level of access this User has to this entity. If null, this User has no access.

nodebalancer
array of objects

The grants this User has for each NodeBalancer that is owned by this Account.

id
integer

The ID of the entity this grant applies to.

permissions
Nullable
string
Enum: read_only read_write

The level of access this User has to this entity. If null, this User has no access.

stackscript
array of objects

The grants this User has for each StackScript that is owned by this Account.

id
integer

The ID of the entity this grant applies to.

permissions
Nullable
string
Enum: read_only read_write

The level of access this User has to this entity. If null, this User has no access.

volume
array of objects

The grants this User has for each Block Storage Volume that is owned by this Account.

id
integer

The ID of the entity this grant applies to.

permissions
Nullable
string
Enum: read_only read_write

The level of access this User has to this entity. If null, this User has no access.

Response Samples

Responses