Linode API

Disk Root Password Reset Resets the password of a Disk you have permission to `read_write`.

Linode Root Password Reset Resets the root password for this Linode. * Your Linode must be [shut down](/docs/api/linode-instances/#linode-shut-down) for a password reset to complete. * If your Linode has more than one disk (not counting its swap disk), use the [Reset Disk Root Password](/docs/api/linode-instances/#disk-root-password-reset) endpoint to update a specific disk's root password. * A `password_reset` event is generated when a root password reset is successful.

Disk Resize Resizes a Disk you have permission to `read_write`. The Disk must not be in use. If the Disk is in use, the request will succeed but the resize will ultimately fail. For a request to succeed, the Linode must be shut down prior to resizing the Disk, or the Disk must not be assigned to the Linode's active Configuration Profile. If you are resizing the Disk to a smaller size, it cannot be made smaller than what is required by the total size of the files current on the Disk.

Linode Resize Resizes a Linode you have the `read_write` permission to a different Type. If any actions are currently running or queued, those actions must be completed first before you can initiate a resize. Additionally, the following criteria must be met in order to resize a Linode: * The Linode must not have a pending migration. * Your Account cannot have an outstanding balance. * The Linode must not have more disk allocation than the new Type allows. * In that situation, you must first delete or resize the disk to be smaller.

Volume Resize Resize an existing Volume on your Account. In order for this request to complete successfully, your User must have the `read_write` permissions to the Volume. * Volumes can only be resized up. * Only Volumes with a `status` of "active" can be resized.

Backup Restore Restores a Linode's Backup to the specified Linode.

Trusted Device Revoke Revoke an active TrustedDevice for your User. Once a TrustedDevice is revoked, this device will have to log in again before accessing your Linode account.

OAuth Client Thumbnail Update 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.

IP Addresses Share Configure shared IPs. IP sharing allows IP address reassignment (also referred to as IP failover) from one Linode to another if the primary Linode becomes unresponsive. This means that requests to the primary Linode's IP address can be automatically rerouted to secondary Linodes at the configured shared IP addresses. IP failover requires configuration of a failover service (such as [Keepalived](/docs/guides/ip-failover-keepalived)) within the internal system of the primary Linode.

IPv4 Sharing Configure This command is equivalent to **IP Addresses Share** ([POST /networking/ips/share](#ip-addresses-share)). Configure shared IPs. IP sharing allows IP address reassignment (also referred to as IP failover) from one Linode to another if the primary Linode becomes unresponsive. This means that requests to the primary Linode's IP address can be automatically rerouted to secondary Linodes at the configured shared IP addresses. IP failover requires configuration of a failover service (such as [Keepalived](/docs/guides/ip-failover-keepalived)) within the internal system of the primary Linode.

Linode Shut Down Shuts down a Linode you have permission to modify. If any actions are currently running or queued, those actions must be completed first before you can initiate a shutdown.

Two Factor Authentication Confirm/Enable Confirms that you can successfully generate Two Factor codes and enables TFA on your Account. Once this is complete, login attempts from untrusted computers will be required to provide a Two Factor code before they are successful.

Two Factor Authentication Disable Disables Two Factor Authentication for your User. Once successful, login attempts from untrusted computers will only require a password before being successful. This is less secure, and is discouraged.

Two Factor Secret Create Generates a Two Factor secret for your User. To enable TFA for your User, enter the secret obtained from this command with the **Two Factor Authentication Confirm/Enable** ([POST /profile/tfa-enable-confirm](/docs/api/profile/#two-factor-authentication-confirmenable)) command. Once enabled, logins from untrusted computers are required to provide a TFA code before they are successful. **Note**: Before you can enable TFA, security questions must be answered for your User by accessing the **Security Questions Answer** ([POST /profile/security-questions](/docs/api/profile/#security-questions-answer)) command.

Account Update Updates contact and billing information related to your Account.

Account Settings Update Updates your Account settings. To update your Longview subscription plan, send a request to [Update Longview Plan](/docs/api/longview/#longview-plan-update).

OAuth Client Update 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.

Disk Update Updates a Disk that you have permission to `read_write`.

Domain Update Update information about a Domain in Linode's DNS Manager.

Domain Record Update Updates a single Record on this Domain.

Firewall Update Updates information for a Firewall. Some parts of a Firewall's configuration cannot be manipulated by this endpoint: - A Firewall's Devices cannot be set with this endpoint. Instead, use the [Create Firewall Device](/docs/api/networking/#firewall-device-create) and [Delete Firewall Device](/docs/api/networking/#firewall-device-delete) endpoints to assign and remove this Firewall from Linode services. - A Firewall's Rules cannot be changed with this endpoint. Instead, use the [Update Firewall Rules](/docs/api/networking/#firewall-rules-update) endpoint to update your Rules. - A Firewall's status can be set to `enabled` or `disabled` by this endpoint, but it cannot be set to `deleted`. Instead, use the [Delete Firewall](/docs/api/networking/#firewall-delete) endpoint to delete a Firewall. If a Firewall's status is changed with this endpoint, a corresponding `firewall_enable` or `firewall_disable` Event will be generated.

Firewall Rules Update Updates the inbound and outbound Rules for a Firewall. **Note:** This command replaces all of a Firewall's `inbound` and/or `outbound` rulesets with the values specified in your request.

IP Address RDNS Update Sets RDNS on an IP Address. Forward DNS must already be set up for reverse DNS to be applied. If you set the RDNS to `null` for public IPv4 addresses, it will be reset to the default _ip.linodeusercontent.com_ RDNS value.

Image Update Updates a private Image that you have permission to `read_write`.

Configuration Profile Update Updates a Configuration profile.

IP Address Update Updates a the reverse DNS (RDNS) for a particular IP Address associated with this Linode. Setting the RDNS to `null` for a public IPv4 address, resets it to the default "ip.linodeusercontent.com" RDNS value.

Linode Update Updates a Linode that you have permission to `read_write`. **Important**: You must be an unrestricted User in order to add or modify tags on Linodes.

Longview Client Update Updates a Longview Client. This cannot update how it monitors your server; use the Longview Client application on your Linode for monitoring configuration.

Longview Plan Update Update your Longview plan to that of the given subcription ID. This returns a `LongviewSubscription` object for the updated Longview Pro plan, or an empty set `{}` if the updated plan is Longview Free. You must have `"longview_subscription": true` configured as a `global` [User Grant](/docs/api/account/#users-grants-view) in order to access this endpoint. You can send a request to the [List Longview Subscriptions](/docs/api/longview/#longview-subscriptions-list) endpoint to receive the details, including `id`'s, of each plan.

Managed Contact Update Updates information about a Managed Contact. This command can only be accessed by the unrestricted users of an account.

Managed Credential Update Updates the label of a Managed Credential. This endpoint does not update the username and password for a Managed Credential. To do this, use the Managed Credential Username and Password Update ([POST /managed/credentials/{credentialId}/update](/docs/api/managed/#managed-credential-username-and-password-update)) endpoint instead. This command can only be accessed by the unrestricted users of an account.

Managed Credential Username and Password Update Updates the username and password for a Managed Credential. This command can only be accessed by the unrestricted users of an account.

Linode's Managed Settings Update Updates a single Linode's Managed settings. This command can only be accessed by the unrestricted users of an account.

Managed Service Update Updates information about a Managed Service. This command can only be accessed by the unrestricted users of an account.

NodeBalancer Update Updates information about a NodeBalancer you can access.

Config Update Updates the configuration for a single port on a NodeBalancer.

Node Update Updates information about a Node, a backend for this NodeBalancer's configured port.

Object Storage Object ACL Config Update Update an Object's configured Access Control List (ACL) in this Object Storage bucket. ACLs define who can access your buckets and objects and specify the level of access granted to those users. This endpoint is available for convenience. It is recommended that instead you use the more [fully-featured S3 API](https://docs.ceph.com/en/latest/radosgw/s3/objectops/#set-object-acl) directly.

Object Storage Bucket Access Update Allows changing basic Cross-origin Resource Sharing (CORS) and Access Control Level (ACL) settings. Only allows enabling/disabling CORS for all origins, and/or setting canned ACLs. For more fine-grained control of both systems, please use the more [fully-featured S3 API](https://docs.ceph.com/en/latest/radosgw/s3/bucketops/#put-bucket-acl) directly.

Object Storage Key Update Updates an Object Storage Key on your account.

Personal Access Token Update Updates a Personal Access Token.

Profile Update Update information in your Profile. This endpoint requires the "account:read_write" OAuth Scope.

SSH Key Update Updates an SSH Key that you have permission to `read_write`. Only SSH key labels can be updated.

StackScript Update Updates a StackScript. **Once a StackScript is made public, it cannot be made private.**

User Update 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.

User's Grants Update 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.

User Preferences Update Updates a user's preferences. These preferences are tied to the OAuth client that generated the token making the request. The user preferences endpoints allow consumers of the API to store arbitrary JSON data, such as a user's font size preference or preferred display name. An account may have multiple preferences. Preferences, and the pertaining request body, may contain any arbitrary JSON data that the user would like to store.

Volume Update Updates a Volume that you have permission to `read_write`.

Managed SSH Key View Returns the unique SSH public key assigned to your Linode account's Managed service. If you [add this public key](/docs/guides/linode-managed/#adding-the-public-key) to a Linode on your account, Linode special forces will be able to log in to the Linode with this key when attempting to resolve issues. This command can only be accessed by the unrestricted users of an account.

Object Storage Object ACL Config View View an Object's configured Access Control List (ACL) in this Object Storage bucket. ACLs define who can access your buckets and objects and specify the level of access granted to those users. This endpoint is available for convenience. It is recommended that instead you use the more [fully-featured S3 API](https://docs.ceph.com/en/latest/radosgw/s3/objectops/#get-object-acl) directly.