Update a profile

put

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

Update information in your profile.

Parent and child accounts

In the context of the parent and child accounts feature, delegate users on a child account can't change their email address.

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_profile
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: account:read_write

CLI

linode-cli profile update \
  --email example-user@gmail.com \
  --timezone US/Eastern \
  --email_notifications true \
  --list_auth_method keys_only \
  --two_factor_auth true \
  --restricted false

Learn more

Path Params

apiVersion

string

enum

required

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

Allowed:

Body Params

A profile represents your user in our system. This is where you can change information about your user. This information is available to any OAuth client regardless of requested scopes, and you can use it to populate user information in third-party applications.

authorized_keys

array of strings | null

Your user can use these SSH Keys to access Lish. This value is ignored if lish_auth_method is disabled.

authorized_keys

string

Your email address. We use this address for Akamai Cloud Computing-related communication.

email_notifications

boolean

When set to true, you will receive email notifications about account activity. When false, you may still receive business-critical communications through email.

ip_whitelist_enabled

boolean

deprecated

Deprecated When set to true, your user logins are only allowed from whitelisted IPs. This setting is deprecated, and can't be enabled. If you disable this setting, you won't be able to re-enable it.

lish_auth_method

string

enum

The authentication methods that you can use when connecting to the Linode Shell (Lish).

keys_only is the most secure if you intend to use Lish.
disabled is recommended if you don't want to use Lish.
If this account's Cloud Manager authentication type is set to a third-party authentication method, you can't use password_keys as your Lish authentication method. Run the Get a profile operation to view your account's Cloud Manager authentication_type field.

Allowed:

restricted

boolean

When set to true, there are restrictions on what your user can access on your account. Run List grants to get details on what entities and actions you can access and perform.

timezone

string

The time zone you want to display for your Linode assets. This API doesn't directly use this time zone. It's provided for the benefit of clients such as the Akamai Cloud Manager and other clients built on the API. All times returned by the API are in UTC.

two_factor_auth

boolean

When set to true, a login from an untrusted computer requires two-factor authentication. You also need to run Create a two factor secret to enable two-factor authentication.

Responses

200Profile updated successfully.

defaultSee Errors for the range of possible error response codes.