Linode API

Support Ticket Attachment Create Adds a file attachment to an existing Support Ticket on your Account. File attachments are used to assist our Support team in resolving your Ticket. Examples of attachments are screen shots and text files that provide additional information. The file attachment is submitted in the request as multipart/form-data. **Note**: Accepted file extensions include: .gif, .jpg, .jpeg, .pjpg, .pjpeg, .tif, .tiff, .png, .pdf, or .txt.

Reply Create Adds a reply to an existing Support Ticket.

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

Volume Create Creates a Volume on your Account. In order for this to complete successfully, your User must have the `add_volumes` grant. Creating a new Volume will start accruing additional charges on your account.

OAuth Client Delete 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).

Managed MongoDB Database Backup Delete Delete a single backup for an accessible Managed MongoDB Database. Requires `read_write` access to the Database. The Database must not be provisioning to perform this command. **Note**: New MongoDB Databases cannot currently be created.

Managed MySQL Database Backup Delete Delete a single backup for an accessible Managed MySQL Database. Requires `read_write` access to the Database. The Database must not be provisioning to perform this command.

Managed PostgreSQL Database Backup Delete Delete a single backup for an accessible Managed PostgreSQL Database. Requires `read_write` access to the Database. The Database must not be provisioning to perform this command.

Managed MongoDB Database Delete Remove a Managed MongoDB Database from your Account. Requires `read_write` access to the Database. The Database must have an `active`, `failed`, or `degraded` status to perform this command. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes. **Note**: New MongoDB Databases cannot currently be created.

Managed MySQL Database Delete Remove a Managed MySQL Database from your Account. Requires `read_write` access to the Database. The Database must have an `active`, `failed`, or `degraded` status to perform this command. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.

Managed PostgreSQL Database Delete Remove a Managed PostgreSQL Database from your Account. Requires `read_write` access to the Database. The Database must have an `active`, `failed`, or `degraded` status to perform this command. Only unrestricted Users can access this command, and have access regardless of the acting token's OAuth scopes.

Disk Delete Deletes a Disk you have permission to `read_write`. **Deleting a Disk is a destructive action and cannot be undone.**

Domain Delete Deletes a Domain from Linode's DNS Manager. The Domain will be removed from Linode's nameservers shortly after this operation completes. This also deletes all associated Domain Records.

Domain Record Delete Deletes a Record on this Domain.

Entity Transfer Cancel **DEPRECATED**. Please use [Service Transfer Cancel](/docs/api/account/#service-transfer-cancel).

Firewall Delete Delete a Firewall resource by its ID. This will remove all of the Firewall's Rules from any Linode services that the Firewall was assigned to. A `firewall_delete` Event is generated when this endpoint returns successfully.

Firewall Device Delete Removes a Firewall Device, which removes a Firewall from the Linode service it was assigned to by the Device. This will remove all of the Firewall's Rules from the Linode service. If any other Firewalls have been assigned to the Linode service, then those Rules will remain in effect. A `firewall_device_remove` Event is generated when the Firewall Device is removed successfully.

IPv6 Range Delete Removes this IPv6 range from your account and disconnects the range from any assigned Linodes. **Note:** Shared IPv6 ranges cannot be deleted at this time. Please contact Customer Support for assistance.

Image Delete Deletes a private Image you have permission to `read_write`. **Deleting an Image is a destructive action and cannot be undone.**

Kubernetes Cluster Delete Deletes a Cluster you have permission to `read_write`. **Deleting a Cluster is a destructive action and cannot be undone.** Deleting a Cluster: - Deletes all Linodes in all pools within this Kubernetes cluster - Deletes all supporting Kubernetes services for this Kubernetes cluster (API server, etcd, etc) - Deletes all NodeBalancers created by this Kubernetes cluster - Does not delete any of the volumes created by this Kubernetes cluster

Kubeconfig Delete Delete and regenerate the Kubeconfig file for a Cluster.

Node Delete Deletes a specific Node from a Node Pool. **Deleting a Node is a destructive action and cannot be undone.** Deleting a Node will reduce the size of the Node Pool it belongs to.

Node Pool Delete Delete a specific Node Pool from a Kubernetes cluster. **Deleting a Node Pool is a destructive action and cannot be undone.** Deleting a Node Pool will delete all Linodes within that Pool.

Configuration Profile Delete Deletes the specified Configuration profile from the specified Linode.

Linode Delete Deletes a Linode you have permission to `read_write`. **Deleting a Linode is a destructive action and cannot be undone.** Additionally, deleting a Linode: * Gives up any IP addresses the Linode was assigned. * Deletes all Disks, Backups, Configs, etc. * Stops billing for the Linode and its associated services. You will be billed for time used within the billing period the Linode was active. Linodes that are in the process of [cloning](/docs/api/linode-instances/#linode-clone) or [backup restoration](/docs/api/linode-instances/#backup-restore) cannot be deleted.

Longview Client Delete Deletes a Longview Client from your Account. **All information stored for this client will be lost.** This _does not_ uninstall the Longview Client application for your Linode - you must do that manually.

Managed Contact Delete Deletes a Managed Contact. This command can only be accessed by the unrestricted users of an account.

Managed Credential Delete Deletes a Managed Credential. Linode special forces will no longer have access to this Credential when attempting to resolve issues. This command can only be accessed by the unrestricted users of an account.

Managed Service Delete Deletes a Managed Service. This service will no longer be monitored by Linode Managed. This command can only be accessed by the unrestricted users of an account.

NodeBalancer Delete Deletes a NodeBalancer. **This is a destructive action and cannot be undone.** Deleting a NodeBalancer will also delete all associated Configs and Nodes, although the backend servers represented by the Nodes will not be changed or removed. Deleting a NodeBalancer will cause you to lose access to the IP Addresses assigned to this NodeBalancer.

Config Delete Deletes the Config for a port of this NodeBalancer. **This cannot be undone.** Once completed, this NodeBalancer will no longer respond to requests on the given port. This also deletes all associated NodeBalancerNodes, but the Linodes they were routing traffic to will be unchanged and will not be removed.

Node Delete Deletes a Node from this Config. This backend will no longer receive traffic for the configured port of this NodeBalancer. This does not change or remove the Linode whose address was used in the creation of this Node.

Object Storage Bucket Remove Removes a single bucket. Bucket objects must be removed prior to removing the bucket. While buckets containing objects _may_ be deleted using the [s3cmd command-line tool](/docs/products/storage/object-storage/guides/s3cmd/#delete-a-bucket), such operations can fail if the bucket contains too many objects. The recommended way to empty large buckets is to use the [S3 API to configure lifecycle policies](https://docs.ceph.com/en/latest/radosgw/bucketpolicy/#) that remove all objects, then delete the bucket. 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/bucketops/#delete-bucket) directly.

Object Storage Key Revoke Revokes an Object Storage Key. This keypair will no longer be usable by third-party clients.

Object Storage TLS/SSL Cert Delete Deletes this Object Storage bucket's user uploaded TLS/SSL certificate and private key.

Payment Method Delete 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](/docs/api/account/#payment-method-add)) endpoint. To designate an existing Payment Method as the default method, access the Payment Method Make Default ([POST /account/payment-methods/{paymentMethodId}/make-default](/docs/api/account/#payment-method-make-default)) endpoint.

Personal Access Token Revoke Revokes a Personal Access Token. The token will be invalidated immediately, and requests using that token will fail with a 401. It is possible to revoke access to the token making the request to revoke a token, but keep in mind that doing so could lose you access to the api and require you to create a new token through some other means.

App Access Revoke Expires this app token. This token may no longer be used to access your Account.

Phone Number Delete Delete the verified phone number for the User making this request. Use this command to opt out of SMS messages for the requesting User after a phone number has been verified with the **Phone Number Verify** ([POST /profile/phone-number/verify](/docs/api/profile/#phone-number-verify)) command.

SSH Key Delete Deletes an SSH Key you have access to. **Note:** deleting an SSH Key will *not* remove it from any Linode or Disk that was deployed with `authorized_keys`. In those cases, the keys must be manually deleted on the Linode or Disk. This endpoint will only delete the key's association from your Profile.

Service Transfer Cancel Cancels the Service Transfer for the provided token. Once cancelled, a transfer cannot be accepted or otherwise acted on in any way. If cancelled in error, the transfer must be [created](/docs/api/account/#service-transfer-create) again. When cancelled, an email notification for the cancellation is sent to the account that created this transfer. Transfers can not be cancelled 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.

StackScript Delete Deletes a private StackScript you have permission to `read_write`. You cannot delete a public StackScript.

Tag Delete Remove a Tag from all objects and delete it. **Important**: You must be an unrestricted User in order to add or modify Tags.

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

Volume Delete Deletes a Volume you have permission to `read_write`. * **Deleting a Volume is a destructive action and cannot be undone.** * Deleting stops billing for the Volume. You will be billed for time used within the billing period the Volume was active. * Volumes that are migrating cannot be deleted until the migration is finished.

Volume Detach Detaches a Volume on your Account from a Linode on your Account. In order for this request to complete successfully, your User must have `read_write` access to the Volume and `read_write` access to the Linode.

Managed Service Disable Temporarily disables monitoring of a Managed Service. This command can only be accessed by the unrestricted users of an account.

Linode 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](/docs/guides/linode-managed/) to learn more.

Backups Enable Enables backups for the specified Linode.

Managed Service Enable Enables monitoring of a Managed Service. This command can only be accessed by the unrestricted users of an account.