Update your account

put

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

Updates contact and billing information related to your account. If you exclude any properties from the request, the operation leaves them unchanged.

📘
When updating an account's country to US, you'll get an error if the account's zip is not a valid US zip code.

Parent and child accounts

In the context of the parent and child account environment:

You can't change the company for a parent account.
Child account users can't run this operation.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

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

CLI

linode-cli account update \
  --address_1 "123 Main St." \
  --address_2 "Suite 101" \
  --city Philadelphia \
  --company My Company \ LLC \
  --country US \
  --email jsmith@mycompany.com \
  --first_name John \
  --last_name Smith \
  --phone 555-555-1212 \
  --state PA \
  --tax_id ATU99999999 \
  --zip 19102

Learn more

Path Params

apiVersion

string

enum

required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:

Body Params

Updated contact and billing information.

address_1

string

length ≤ 64

The first line of this account's billing address.

address_2

string

length ≤ 64

The second line of this account's billing address.

city

string

length ≤ 24

The city for this account's address.

company

string

length ≤ 128

The company name assigned to this account. This value can't include the characters, < > ( ) " =.

country

string

The two-letter ISO 3166 country code for this account's address.

string

length ≤ 128

The email address of the person assigned to this account.

first_name

string

length ≤ 50

The first name of the person assigned to this account. This value can't include the characters, < > ( ) " =.

last_name

string

length ≤ 50

The last name of the person assigned to this account. This value can't include the characters, < > ( ) " =.

phone

string

length ≤ 32

The phone number assigned to this account.

state

string

length ≤ 24

The state or province for the address set for your account, if applicable.

If the address is in the United States (US) or Canada (CA), this is the two-letter ISO 3166 code for the state or province.
If it's a US military address, this is the abbreviation for that territory. This includes AA for Armed Forces Americas (excluding Canada), AE for Armed Forces Africa, Europe, Middle East, and Canada, or AP for Armed Forces Pacific.
If outside the US or CA, this is the province associated with the account's address.

tax_id

string

length ≤ 25

The tax identification number (TIN) assigned to this account, used for tax calculations. A TIN is set by the national authorities in your country, based on your address_1, and it may be named differently between countries. Set to an empty string ("") if a TIN doesn't apply or for countries that don't collect tax.

📘
This value is externally validated. If the validation is successful, a tax_id_valid event is triggered. If unsuccessful, a tax_id_invalid event is triggered and an error response is issued for an operation that included it.

zip

string

The zip code for this account's address.

It can only contain ASCII letters, numbers, and dashes (-).
It can't contain more than nine letter or number characters.

Responses

200The updated account.

defaultSee Errors for the range of possible error response codes.