Go API client for v1

Introduction

The Linode API provides the ability to programmatically manage the full range of Linode products and services.

This reference is designed to assist application developers and system administrators. Each endpoint includes descriptions, request syntax, and examples using standard HTTP requests. Response data is returned in JSON format.

This document was generated from our OpenAPI Specification. See the <a target="_top" href="https://www.openapis.org\">OpenAPI website for more information.

<a target="_top" href="/docs/api/openapi.yaml">Download the Linode OpenAPI Specification.

Changelog

<a target="_top" href="https://developers.linode.com/changelog\">View our Changelog to see release notes on all changes made to our API.

Access and Authentication

Some endpoints are publicly accessible without requiring authentication. All endpoints affecting your Account, however, require either a Personal Access Token or OAuth authentication (when using third-party applications).

Personal Access Token

The easiest way to access the API is with a Personal Access Token (PAT) generated from the <a target="_top" href="https://cloud.linode.com/profile/tokens\">Linode Cloud Manager or the Create Personal Access Token endpoint.

All scopes for the OAuth security model (defined below) apply to this security model as well.

Authentication

Security Scheme Type:	HTTP
HTTP Authorization Scheme	bearer

OAuth

If you only need to access the Linode API for personal use, we recommend that you create a personal access token. If you're designing an application that can authenticate with an arbitrary Linode user, then you should use the OAuth 2.0 workflows presented in this section.

For a more detailed example of an OAuth 2.0 implementation, see our guide on How to Create an OAuth App with the Linode Python API Library.

Before you implement OAuth in your application, you first need to create an OAuth client. You can do this with the Linode API or via the Cloud Manager:

When creating the client, you'll supply a label and a redirect_uri (referred to as the Callback URL in the Cloud Manager).
The response from this endpoint will give you a client_id and a secret.
Clients can be public or private, and are private by default. You can choose to make the client public when it is created.
- A private client is used with applications which can securely store the client secret (that is, the secret returned to you when you first created the client). For example, an application running on a secured server that only the developer has access to would use a private OAuth client. This is also called a confidential client in some OAuth documentation.
- A public client is used with applications where the client secret is not guaranteed to be secure. For example, a native app running on a user's computer may not be able to keep the client secret safe, as a user could potentially inspect the source of the application. So, native apps or apps that run in a user's browser should use a public client.
- Public and private clients follow different workflows, as described below.

OAuth Workflow

The OAuth workflow is a series of exchanges between your third-party app and Linode. The workflow is used to authenticate a user before an application can start making API calls on the user's behalf.

Notes:

With respect to the diagram in section 1.2 of RFC 6749, login.linode.com (referred to in this section as the login server) is the Resource Owner and the Authorization Server; api.linode.com (referred to here as the api server) is the Resource Server.
The OAuth spec refers to the private and public workflows listed below as the authorization code flow and implicit flow.

PRIVATE WORKFLOW	PUBLIC WORKFLOW
1. The user visits the application's website and is directed to login with Linode.	1. The user visits the application's website and is directed to login with Linode.
2. Your application then redirects the user to Linode's login server with the client application's `client_id` and requested OAuth `scope`, which should appear in the URL of the login page.	2. Your application then redirects the user to Linode's login server with the client application's `client_id` and requested OAuth `scope`, which should appear in the URL of the login page.
3. The user logs into the login server with their username and password.	3. The user logs into the login server with their username and password.
4. The login server redirects the user to the specificed redirect URL with a temporary authorization `code` (exchange code) in the URL.	4. The login server redirects the user back to your application with an OAuth `access_token` embedded in the redirect URL's hash. This is temporary and expires in two hours. No `refresh_token` is issued. Therefore, once the `access_token` expires, a new one will need to be issued by having the user log in again.
5. The application issues a POST request (see below) to the login server with the exchange code, `client_id`, and the client application's `client_secret`.
6. The login server responds to the client application with a new OAuth `access_token` and `refresh_token`. The `access_token` is set to expire in two hours.
7. The `refresh_token` can be used by contacting the login server with the `client_id`, `client_secret`, `grant_type`, and `refresh_token` to get a new OAuth `access_token` and `refresh_token`. The new `access_token` is good for another two hours, and the new `refresh_token`, can be used to extend the session again by this same method.

OAuth Private Workflow - Additional Details

The following information expands on steps 5 through 7 of the private workflow:

Once the user has logged into Linode and you have received an exchange code, you will need to trade that exchange code for an access_token and refresh_token. You do this by making an HTTP POST request to the following address:

https://login.linode.com/oauth/token

Make this request as application/x-www-form-urlencoded or as multipart/form-data and include the following parameters in the POST body:

PARAMETER	DESCRIPTION
grant_type	The grant type you're using for renewal. Currently only the string "refresh_token" is accepted.
client_id	Your app's client ID.
client_secret	Your app's client secret.
code	The code you just received from the redirect.

You'll get a response like this:

{
  \"scope\": \"linodes:read_write\",
  \"access_token\": \"03d084436a6c91fbafd5c4b20c82e5056a2e9ce1635920c30dc8d81dc7a6665c\"
  \"token_type\": \"bearer\",
  \"expires_in\": 7200,
}

Included in the reponse is an access_token. With this token, you can proceed to make authenticated HTTP requests to the API by adding this header to each request:

Authorization: Bearer 03d084436a6c91fbafd5c4b20c82e5056a2e9ce1635920c30dc8d81dc7a6665c

OAuth Reference

Security Scheme Type	OAuth 2.0
Authorization URL	https://login.linode.com/oauth/authorize
Token URL	https://login.linode.com/oauth/token
Scopes	`account:read_only` - Allows access to GET information about your Account. `account:read_write` - Allows access to all endpoints related to your Account. `domains:read_only` - Allows access to GET Domains on your Account. `domains:read_write` - Allows access to all Domain endpoints. `events:read_only` - Allows access to GET your Events. `events:read_write` - Allows access to all endpoints related to your Events. `firewall:read_only` - Allows access to GET information about your Firewalls. `firewall:read_write` - Allows access to all Firewall endpoints. `images:read_only` - Allows access to GET your Images. `images:read_write` - Allows access to all endpoints related to your Images. `ips:read_only` - Allows access to GET your ips. `ips:read_write` - Allows access to all endpoints related to your ips. `linodes:read_only` - Allows access to GET Linodes on your Account. `linodes:read_write` - Allow access to all endpoints related to your Linodes. `lke:read_only` - Allows access to GET LKE Clusters on your Account. `lke:read_write` - Allows access to all endpoints related to LKE Clusters on your Account. `longview:read_only` - Allows access to GET your Longview Clients. `longview:read_write` - Allows access to all endpoints related to your Longview Clients. `maintenance:read_only` - Allows access to GET information about Maintenance on your account. `nodebalancers:read_only` - Allows access to GET NodeBalancers on your Account. `nodebalancers:read_write` - Allows access to all NodeBalancer endpoints. `object_storage:read_only` - Allows access to GET information related to your Object Storage. `object_storage:read_write` - Allows access to all Object Storage endpoints. `stackscripts:read_only` - Allows access to GET your StackScripts. `stackscripts:read_write` - Allows access to all endpoints related to your StackScripts. `volumes:read_only` - Allows access to GET your Volumes. `volumes:read_write` - Allows access to all endpoints related to your Volumes.

Requests

Requests must be made over HTTPS to ensure transactions are encrypted. The following Request methods are supported:

METHOD	USAGE
GET	Retrieves data about collections and individual resources.
POST	For collections, creates a new resource of that type. Also used to perform actions on action endpoints.
PUT	Updates an existing resource.
DELETE	Deletes a resource. This is a destructive action.

Responses

Actions will return one following HTTP response status codes:

STATUS	DESCRIPTION
200 OK	The request was successful.
204 No Content	The server successfully fulfilled the request and there is no additional content to send.
400 Bad Request	You submitted an invalid request (missing parameters, etc.).
401 Unauthorized	You failed to authenticate for this resource.
403 Forbidden	You are authenticated, but don't have permission to do this.
404 Not Found	The resource you're requesting does not exist.
429 Too Many Requests	You've hit a rate limit.
500 Internal Server Error	Please open a Support Ticket.

Errors

Success is indicated via <a href="https://en.wikipedia.org/wiki/List_of_HTTP_status_codes\" target="_top">Standard HTTP status codes. 2xx codes indicate success, 4xx codes indicate a request error, and 5xx errors indicate a server error. A request error might be an invalid input, a required parameter being omitted, or a malformed request. A server error means something went wrong processing your request. If this occurs, please open a Support Ticket and let us know. Though errors are logged and we work quickly to resolve issues, opening a ticket and providing us with reproducable steps and data is always helpful.

The errors field is an array of the things that went wrong with your request. We will try to include as many of the problems in the response as possible, but it's conceivable that fixing these errors and resubmitting may result in new errors coming back once we are able to get further along in the process of handling your request.

Within each error object, the field parameter will be included if the error pertains to a specific field in the JSON you've submitted. This will be omitted if there is no relevant field. The reason is a human-readable explanation of the error, and will always be included.

Pagination

Resource lists are always paginated. The response will look similar to this:

{
    \"data\": [ ... ],
    \"page\": 1,
    \"pages\": 3,
    \"results\": 300
}

Pages start at 1. You may retrieve a specific page of results by adding ?page=x to your URL (for example, ?page=4). If the value of page exceeds 2^64/page_size, the last possible page will be returned.
Page sizes default to 100, and can be set to return between 25 and 500. Page size can be set using ?page_size=x.

Filtering and Sorting

Collections are searchable by fields they include, marked in the spec as x-linode-filterable: true. Filters are passed in the X-Filter header and are formatted as JSON objects. Here is a request call for Linode Types in our "standard" class:

curl \"https://api.linode.com/v4/linode/types\" \\
  -H '
    X-Filter: {
      \"class\": \"standard\"
    }'

The filter object's keys are the keys of the object you're filtering, and the values are accepted values. You can add multiple filters by including more than one key. For example, filtering for "standard" Linode Types that offer one vcpu:

 curl \"https://api.linode.com/v4/linode/types\" \\
  -H '
    X-Filter: {
      \"class\": \"standard\",
      \"vcpus\": 1
    }'

In the above example, both filters are combined with an "and" operation. However, if you wanted either Types with one vcpu or Types in our "standard" class, you can add an operator:

curl \"https://api.linode.com/v4/linode/types\" \\
 -H '
   X-Filter: {
     \"+or\": [
       { \"vcpus\": 1 },
       { \"class\": \"standard\" }
     ]
   }'

Each filter in the +or array is its own filter object, and all conditions in it are combined with an "and" operation as they were in the previous example.

Other operators are also available. Operators are keys of a Filter JSON object. Their value must be of the appropriate type, and they are evaluated as described below:

OPERATOR	TYPE	DESCRIPTION
+and	array	All conditions must be true.
+or	array	One condition must be true.
+gt	number	Value must be greater than number.
+gte	number	Value must be greater than or equal to number.
+lt	number	Value must be less than number.
+lte	number	Value must be less than or equal to number.
+contains	string	Given string must be in the value.
+neq	string	Does not equal the value.
+order_by	string	Attribute to order the results by - must be filterable.
+order	string	Either "asc" or "desc". Defaults to "asc". Requires `+order_by`.

For example, filtering for Linode Types that offer memory equal to or higher than 61440:

curl \"https://api.linode.com/v4/linode/types\" \\
  -H '
    X-Filter: {
      \"memory\": {
        \"+gte\": 61440
      }
    }'

You can combine and nest operators to construct arbitrarily-complex queries. For example, give me all Linode Types which are either standard or highmem class, or have between 12 and 20 vcpus:

curl \"https://api.linode.com/v4/linode/types\" \\
  -H '
    X-Filter: {
      \"+or\": [
        {
          \"+or\": [
            {
              \"class\": \"standard\"
            },
            {
              \"class\": \"highmem\"
            }
          ]
        },
        {
          \"+and\": [
            {
              \"vcpus\": {
                \"+gte\": 12
              }
            },
            {
              \"vcpus\": {
                \"+lte\": 20
              }
            }
          ]
        }
      ]
    }'

Rate Limiting

With the Linode API, you can make up to 1,600 general API requests every two minutes per user as determined by IP adddress or by OAuth token. Additionally, there are endpoint specfic limits defined below.

Note: There may be rate limiting applied at other levels outside of the API, for example, at the load balancer.

/stats endpoints have their own dedicated limits of 100 requests per minute per user. These endpoints are:

Object Storage endpoints have a dedicated limit of 750 requests per second per user. The Object Storage endpoints are:

Object Storage Endpoints

Opening Support Tickets has a dedicated limit of 2 requests per minute per user. That endpoint is:

Open Support Ticket

Accepting Entity Transfers has a dedicated limit of 2 requests per minute per user. That endpoint is:

Entity Transfer Accept

CLI (Command Line Interface)

The <a href="https://github.com/linode/linode-cli\" target="_top">Linode CLI allows you to easily work with the API using intuitive and simple syntax. It requires a Personal Access Token for authentication, and gives you access to all of the features and functionality of the Linode API that are documented here with CLI examples.

Endpoints that do not have CLI examples are currently unavailable through the CLI, but can be accessed via other methods such as Shell commands and other third-party applications.

Overview

This API client was generated by the OpenAPI Generator project. By using the OpenAPI-spec from a remote server, you can easily generate an API client.

API version: 4.85.0
Package version: 1.0.0
Build package: org.openapitools.codegen.languages.GoClientCodegen For more information, please visit https://www.linode.com/support/

Installation

Install the following dependencies:

go get github.com/stretchr/testify/assert
go get golang.org/x/oauth2
go get golang.org/x/net/context

Put the package under your project folder and add the following in import:

import sw "./v1"

To use a proxy, set the environment variable HTTP_PROXY:

os.Setenv("HTTP_PROXY", "http://proxy_name:proxy_port")

Configuration of Server URL

Default configuration comes with Servers field that contains server objects as defined in the OpenAPI specification.

Select Server Configuration

For using other server than the one defined on index 0 set context value sw.ContextServerIndex of type int.

ctx := context.WithValue(context.Background(), sw.ContextServerIndex, 1)

Templated Server URL

Templated server URL is formatted using default variables from configuration or from context value sw.ContextServerVariables of type map[string]string.

ctx := context.WithValue(context.Background(), sw.ContextServerVariables, map[string]string{
	"basePath": "v2",
})

Note, enum values are always validated and all unused variables are silently ignored.

URLs Configuration per Operation

Each operation can use different server URL defined using OperationServers map in the Configuration. An operation is uniquely identifield by "{classname}Service.{nickname}" string. Similar rules for overriding default operation server index and variables applies by using sw.ContextOperationServerIndices and sw.ContextOperationServerVariables context maps.

ctx := context.WithValue(context.Background(), sw.ContextOperationServerIndices, map[string]int{
	"{classname}Service.{nickname}": 2,
})
ctx = context.WithValue(context.Background(), sw.ContextOperationServerVariables, map[string]map[string]string{
	"{classname}Service.{nickname}": {
		"port": "8443",
	},
})

Documentation for API Endpoints

All URIs are relative to https://api.linode.com/v4

Class	Method	HTTP request	Description
AccountApi	AcceptEntityTransfer	Post /account/entity-transfers/{token}/accept	Entity Transfer Accept
AccountApi	CancelAccount	Post /account/cancel	Account Cancel
AccountApi	CreateClient	Post /account/oauth-clients	OAuth Client Create
AccountApi	CreateCreditCard	Post /account/credit-card	Credit Card Add/Edit
AccountApi	CreateEntityTransfer	Post /account/entity-transfers	Entity Transfer Create
AccountApi	CreatePayPalPayment	Post /account/payments/paypal	PayPal Payment Stage
AccountApi	CreatePayment	Post /account/payments	Payment Make
AccountApi	CreateUser	Post /account/users	User Create
AccountApi	DeleteClient	Delete /account/oauth-clients/{clientId}	OAuth Client Delete
AccountApi	DeleteEntityTransfer	Delete /account/entity-transfers/{token}	Entity Transfer Cancel
AccountApi	DeleteUser	Delete /account/users/{username}	User Delete
AccountApi	EnableAccountManged	Post /account/settings/managed-enable	Linode Managed Enable
AccountApi	EventRead	Post /account/events/{eventId}/read	Event Mark as Read
AccountApi	EventSeen	Post /account/events/{eventId}/seen	Event Mark as Seen
AccountApi	ExecutePayPalPayment	Post /account/payments/paypal/execute	Staged/Approved PayPal Payment Execute
AccountApi	GetAccount	Get /account	Account View
AccountApi	GetAccountLogin	Get /account/logins/{loginId}	Login View
AccountApi	GetAccountLogins	Get /account/logins	User Logins List All
AccountApi	GetAccountSettings	Get /account/settings	Account Settings View
AccountApi	GetClient	Get /account/oauth-clients/{clientId}	OAuth Client View
AccountApi	GetClientThumbnail	Get /account/oauth-clients/{clientId}/thumbnail	OAuth Client Thumbnail View
AccountApi	GetClients	Get /account/oauth-clients	OAuth Clients List
AccountApi	GetEntityTransfer	Get /account/entity-transfers/{token}	Entity Transfer View
AccountApi	GetEntityTransfers	Get /account/entity-transfers	Entity Transfers List
AccountApi	GetEvent	Get /account/events/{eventId}	Event View
AccountApi	GetEvents	Get /account/events	Events List
AccountApi	GetInvoice	Get /account/invoices/{invoiceId}	Invoice View
AccountApi	GetInvoiceItems	Get /account/invoices/{invoiceId}/items	Invoice Items List
AccountApi	GetInvoices	Get /account/invoices	Invoices List
AccountApi	GetMaintenance	Get /account/maintenance	Maintenance List
AccountApi	GetNotifications	Get /account/notifications	Notifications List
AccountApi	GetPayment	Get /account/payments/{paymentId}	Payment View
AccountApi	GetPayments	Get /account/payments	Payments List
AccountApi	GetTransfer	Get /account/transfer	Network Utilization View
AccountApi	GetUser	Get /account/users/{username}	User View
AccountApi	GetUserGrants	Get /account/users/{username}/grants	User's Grants View
AccountApi	GetUsers	Get /account/users	Users List
AccountApi	ResetClientSecret	Post /account/oauth-clients/{clientId}/reset-secret	OAuth Client Secret Reset
AccountApi	SetClientThumbnail	Put /account/oauth-clients/{clientId}/thumbnail	OAuth Client Thumbnail Update
AccountApi	UpdateAccount	Put /account	Account Update
AccountApi	UpdateAccountSettings	Put /account/settings	Account Settings Update
AccountApi	UpdateClient	Put /account/oauth-clients/{clientId}	OAuth Client Update
AccountApi	UpdateUser	Put /account/users/{username}	User Update
AccountApi	UpdateUserGrants	Put /account/users/{username}/grants	User's Grants Update
DomainsApi	CloneDomain	Post /domains/{domainId}/clone	Domain Clone
DomainsApi	CreateDomain	Post /domains	Domain Create
DomainsApi	CreateDomainRecord	Post /domains/{domainId}/records	Domain Record Create
DomainsApi	DeleteDomain	Delete /domains/{domainId}	Domain Delete
DomainsApi	DeleteDomainRecord	Delete /domains/{domainId}/records/{recordId}	Domain Record Delete
DomainsApi	GetDomain	Get /domains/{domainId}	Domain View
DomainsApi	GetDomainRecord	Get /domains/{domainId}/records/{recordId}	Domain Record View
DomainsApi	GetDomainRecords	Get /domains/{domainId}/records	Domain Records List
DomainsApi	GetDomains	Get /domains	Domains List
DomainsApi	ImportDomain	Post /domains/import	Domain Import
DomainsApi	UpdateDomain	Put /domains/{domainId}	Domain Update
DomainsApi	UpdateDomainRecord	Put /domains/{domainId}/records/{recordId}	Domain Record Update
ImagesApi	CreateImage	Post /images	Image Create
ImagesApi	DeleteImage	Delete /images/{imageId}	Image Delete
ImagesApi	GetImage	Get /images/{imageId}	Image View
ImagesApi	GetImages	Get /images	Images List
ImagesApi	UpdateImage	Put /images/{imageId}	Image Update
LinodeInstancesApi	AddLinodeConfig	Post /linode/instances/{linodeId}/configs	Configuration Profile Create
LinodeInstancesApi	AddLinodeDisk	Post /linode/instances/{linodeId}/disks	Disk Create
LinodeInstancesApi	AddLinodeIP	Post /linode/instances/{linodeId}/ips	IPv4 Address Allocate
LinodeInstancesApi	BootLinodeInstance	Post /linode/instances/{linodeId}/boot	Linode Boot
LinodeInstancesApi	CancelBackups	Post /linode/instances/{linodeId}/backups/cancel	Backups Cancel
LinodeInstancesApi	CloneLinodeDisk	Post /linode/instances/{linodeId}/disks/{diskId}/clone	Disk Clone
LinodeInstancesApi	CloneLinodeInstance	Post /linode/instances/{linodeId}/clone	Linode Clone
LinodeInstancesApi	CreateLinodeInstance	Post /linode/instances	Linode Create
LinodeInstancesApi	CreateSnapshot	Post /linode/instances/{linodeId}/backups	Snapshot Create
LinodeInstancesApi	DeleteDisk	Delete /linode/instances/{linodeId}/disks/{diskId}	Disk Delete
LinodeInstancesApi	DeleteLinodeConfig	Delete /linode/instances/{linodeId}/configs/{configId}	Configuration Profile Delete
LinodeInstancesApi	DeleteLinodeInstance	Delete /linode/instances/{linodeId}	Linode Delete
LinodeInstancesApi	EnableBackups	Post /linode/instances/{linodeId}/backups/enable	Backups Enable
LinodeInstancesApi	GetBackup	Get /linode/instances/{linodeId}/backups/{backupId}	Backup View
LinodeInstancesApi	GetBackups	Get /linode/instances/{linodeId}/backups	Backups List
LinodeInstancesApi	GetKernel	Get /linode/kernels/{kernelId}	Kernel View
LinodeInstancesApi	GetKernels	Get /linode/kernels	Kernels List
LinodeInstancesApi	GetLinodeConfig	Get /linode/instances/{linodeId}/configs/{configId}	Configuration Profile View
LinodeInstancesApi	GetLinodeConfigs	Get /linode/instances/{linodeId}/configs	Configuration Profiles List
LinodeInstancesApi	GetLinodeDisk	Get /linode/instances/{linodeId}/disks/{diskId}	Disk View
LinodeInstancesApi	GetLinodeDisks	Get /linode/instances/{linodeId}/disks	Disks List
LinodeInstancesApi	GetLinodeFirewalls	Get /linode/instances/{linodeId}/firewalls	Firewalls List
LinodeInstancesApi	GetLinodeIP	Get /linode/instances/{linodeId}/ips/{address}	IP Address View
LinodeInstancesApi	GetLinodeIPs	Get /linode/instances/{linodeId}/ips	Networking Information List
LinodeInstancesApi	GetLinodeInstance	Get /linode/instances/{linodeId}	Linode View
LinodeInstancesApi	GetLinodeInstances	Get /linode/instances	Linodes List
LinodeInstancesApi	GetLinodeStats	Get /linode/instances/{linodeId}/stats	Linode Statistics View
LinodeInstancesApi	GetLinodeStatsByYearMonth	Get /linode/instances/{linodeId}/stats/{year}/{month}	Statistics View (year/month)
LinodeInstancesApi	GetLinodeTransfer	Get /linode/instances/{linodeId}/transfer	Network Transfer View
LinodeInstancesApi	GetLinodeTransferByYearMonth	Get /linode/instances/{linodeId}/transfer/{year}/{month}	Network Transfer View (year/month)
LinodeInstancesApi	GetLinodeVolumes	Get /linode/instances/{linodeId}/volumes	Linode's Volumes List
LinodeInstancesApi	MigrateLinodeInstance	Post /linode/instances/{linodeId}/migrate	DC Migration/Pending Host Migration Initiate
LinodeInstancesApi	MutateLinodeInstance	Post /linode/instances/{linodeId}/mutate	Linode Upgrade
LinodeInstancesApi	RebootLinodeInstance	Post /linode/instances/{linodeId}/reboot	Linode Reboot
LinodeInstancesApi	RebuildLinodeInstance	Post /linode/instances/{linodeId}/rebuild	Linode Rebuild
LinodeInstancesApi	RemoveLinodeIP	Delete /linode/instances/{linodeId}/ips/{address}	IPv4 Address Delete
LinodeInstancesApi	RescueLinodeInstance	Post /linode/instances/{linodeId}/rescue	Linode Boot into Rescue Mode
LinodeInstancesApi	ResetDiskPassword	Post /linode/instances/{linodeId}/disks/{diskId}/password	Disk Root Password Reset
LinodeInstancesApi	ResetLinodePassword	Post /linode/instances/{linodeId}/password	Linode Root Password Reset
LinodeInstancesApi	ResizeDisk	Post /linode/instances/{linodeId}/disks/{diskId}/resize	Disk Resize
LinodeInstancesApi	ResizeLinodeInstance	Post /linode/instances/{linodeId}/resize	Linode Resize
LinodeInstancesApi	RestoreBackup	Post /linode/instances/{linodeId}/backups/{backupId}/restore	Backup Restore
LinodeInstancesApi	ShutdownLinodeInstance	Post /linode/instances/{linodeId}/shutdown	Linode Shut Down
LinodeInstancesApi	UpdateDisk	Put /linode/instances/{linodeId}/disks/{diskId}	Disk Update
LinodeInstancesApi	UpdateLinodeConfig	Put /linode/instances/{linodeId}/configs/{configId}	Configuration Profile Update
LinodeInstancesApi	UpdateLinodeIP	Put /linode/instances/{linodeId}/ips/{address}	IP Address Update
LinodeInstancesApi	UpdateLinodeInstance	Put /linode/instances/{linodeId}	Linode Update
LinodeKubernetesEngineLKEApi	CreateLKECluster	Post /lke/clusters	Kubernetes Cluster Create
LinodeKubernetesEngineLKEApi	DeleteLKECluster	Delete /lke/clusters/{clusterId}	Kubernetes Cluster Delete
LinodeKubernetesEngineLKEApi	DeleteLKENodePool	Delete /lke/clusters/{clusterId}/pools/{poolId}	Node Pool Delete
LinodeKubernetesEngineLKEApi	GetLKECluster	Get /lke/clusters/{clusterId}	Kubernetes Cluster View
LinodeKubernetesEngineLKEApi	GetLKEClusterAPIEndpoints	Get /lke/clusters/{clusterId}/api-endpoints	Kubernetes API Endpoints List
LinodeKubernetesEngineLKEApi	GetLKEClusterKubeconfig	Get /lke/clusters/{clusterId}/kubeconfig	Kubeconfig View
LinodeKubernetesEngineLKEApi	GetLKEClusterNode	Get /lke/clusters/{clusterId}/nodes/{nodeId}	Node View
LinodeKubernetesEngineLKEApi	GetLKEClusterPools	Get /lke/clusters/{clusterId}/pools	Node Pools List
LinodeKubernetesEngineLKEApi	GetLKEClusters	Get /lke/clusters	Kubernetes Clusters List
LinodeKubernetesEngineLKEApi	GetLKENodePool	Get /lke/clusters/{clusterId}/pools/{poolId}	Node Pool View
LinodeKubernetesEngineLKEApi	GetLKEVersion	Get /lke/versions/{version}	Kubernetes Version View
LinodeKubernetesEngineLKEApi	GetLKEVersions	Get /lke/versions	Kubernetes Versions List
LinodeKubernetesEngineLKEApi	PostLKEClusterNodeRecycle	Post /lke/clusters/{clusterId}/nodes/{nodeId}/recycle	Node Recycle
LinodeKubernetesEngineLKEApi	PostLKEClusterPoolRecycle	Post /lke/clusters/{clusterId}/pools/{poolId}/recycle	Node Pool Recycle
LinodeKubernetesEngineLKEApi	PostLKEClusterPools	Post /lke/clusters/{clusterId}/pools	Node Pool Create
LinodeKubernetesEngineLKEApi	PostLKEClusterRecycle	Post /lke/clusters/{clusterId}/recycle	Cluster Nodes Recycle
LinodeKubernetesEngineLKEApi	PutLKECluster	Put /lke/clusters/{clusterId}	Kubernetes Cluster Update
LinodeKubernetesEngineLKEApi	PutLKENodePool	Put /lke/clusters/{clusterId}/pools/{poolId}	Node Pool Update
LinodeTypesApi	GetLinodeType	Get /linode/types/{typeId}	Type View
LinodeTypesApi	GetLinodeTypes	Get /linode/types	Types List
LongviewApi	CreateLongviewClient	Post /longview/clients	Longview Client Create
LongviewApi	DeleteLongviewClient	Delete /longview/clients/{clientId}	Longview Client Delete
LongviewApi	GetLongviewClient	Get /longview/clients/{clientId}	Longview Client View
LongviewApi	GetLongviewClients	Get /longview/clients	Longview Clients List
LongviewApi	GetLongviewPlan	Get /longview/plan	Longview Plan View
LongviewApi	GetLongviewSubscription	Get /longview/subscriptions/{subscriptionId}	Longview Subscription View
LongviewApi	GetLongviewSubscriptions	Get /longview/subscriptions	Longview Subscriptions List
LongviewApi	UpdateLongviewClient	Put /longview/clients/{clientId}	Longview Client Update
LongviewApi	UpdateLongviewPlan	Put /longview/plan	Longview Plan Update
ManagedApi	CreateManagedContact	Post /managed/contacts	Managed Contact Create
ManagedApi	CreateManagedCredential	Post /managed/credentials	Managed Credential Create
ManagedApi	CreateManagedService	Post /managed/services	Managed Service Create
ManagedApi	DeleteManagedContact	Delete /managed/contacts/{contactId}	Managed Contact Delete
ManagedApi	DeleteManagedCredential	Post /managed/credentials/{credentialId}/revoke	Managed Credential Delete
ManagedApi	DeleteManagedService	Delete /managed/services/{serviceId}	Managed Service Delete
ManagedApi	DisableManagedService	Post /managed/services/{serviceId}/disable	Managed Service Disable
ManagedApi	EnableManagedService	Post /managed/services/{serviceId}/enable	Managed Service Enable
ManagedApi	GetManagedContact	Get /managed/contacts/{contactId}	Managed Contact View
ManagedApi	GetManagedContacts	Get /managed/contacts	Managed Contacts List
ManagedApi	GetManagedCredential	Get /managed/credentials/{credentialId}	Managed Credential View
ManagedApi	GetManagedCredentials	Get /managed/credentials	Managed Credentials List
ManagedApi	GetManagedIssue	Get /managed/issues/{issueId}	Managed Issue View
ManagedApi	GetManagedIssues	Get /managed/issues	Managed Issues List
ManagedApi	GetManagedLinodeSetting	Get /managed/linode-settings/{linodeId}	Linode's Managed Settings View
ManagedApi	GetManagedLinodeSettings	Get /managed/linode-settings	Managed Linode Settings List
ManagedApi	GetManagedService	Get /managed/services/{serviceId}	Managed Service View
ManagedApi	GetManagedServices	Get /managed/services	Managed Services List
ManagedApi	GetManagedStats	Get /managed/stats	Managed Stats List
ManagedApi	UpdateManagedContact	Put /managed/contacts/{contactId}	Managed Contact Update
ManagedApi	UpdateManagedCredential	Put /managed/credentials/{credentialId}	Managed Credential Update
ManagedApi	UpdateManagedCredentialUsernamePassword	Post /managed/credentials/{credentialId}/update	Managed Credential Username and Password Update
ManagedApi	UpdateManagedLinodeSetting	Put /managed/linode-settings/{linodeId}	Linode's Managed Settings Update
ManagedApi	UpdateManagedService	Put /managed/services/{serviceId}	Managed Service Update
ManagedApi	ViewManagedSSHKey	Get /managed/credentials/sshkey	Managed SSH Key View
NetworkingApi	AllocateIP	Post /networking/ips	IP Address Allocate
NetworkingApi	AssignIPs	Post /networking/ipv4/assign	Linodes Assign IPs
NetworkingApi	CreateFirewallDevice	Post /networking/firewalls/{firewallId}/devices	Firewall Device Create
NetworkingApi	CreateFirewalls	Post /networking/firewalls	Firewall Create
NetworkingApi	DeleteFirewall	Delete /networking/firewalls/{firewallId}	Firewall Delete
NetworkingApi	DeleteFirewallDevice	Delete /networking/firewalls/{firewallId}/devices/{deviceId}	Firewall Device Delete
NetworkingApi	GetFirewall	Get /networking/firewalls/{firewallId}	Firewall View
NetworkingApi	GetFirewallDevice	Get /networking/firewalls/{firewallId}/devices/{deviceId}	Firewall Device View
NetworkingApi	GetFirewallDevices	Get /networking/firewalls/{firewallId}/devices	Firewall Devices List
NetworkingApi	GetFirewallRules	Get /networking/firewalls/{firewallId}/rules	Firewall Rules List
NetworkingApi	GetFirewalls	Get /networking/firewalls	Firewalls List
NetworkingApi	GetIP	Get /networking/ips/{address}	IP Address View
NetworkingApi	GetIPs	Get /networking/ips	IP Addresses List
NetworkingApi	GetIPv6Pools	Get /networking/ipv6/pools	IPv6 Pools List
NetworkingApi	GetIPv6Ranges	Get /networking/ipv6/ranges	IPv6 Ranges List
NetworkingApi	ShareIPs	Post /networking/ipv4/share	IP Sharing Configure
NetworkingApi	UpdateFirewall	Put /networking/firewalls/{firewallId}	Firewall Update
NetworkingApi	UpdateFirewallRules	Put /networking/firewalls/{firewallId}/rules	Firewall Rules Update
NetworkingApi	UpdateIP	Put /networking/ips/{address}	IP Address RDNS Update
NodeBalancersApi	CreateNodeBalancer	Post /nodebalancers	NodeBalancer Create
NodeBalancersApi	CreateNodeBalancerConfig	Post /nodebalancers/{nodeBalancerId}/configs	Config Create
NodeBalancersApi	CreateNodeBalancerNode	Post /nodebalancers/{nodeBalancerId}/configs/{configId}/nodes	Node Create
NodeBalancersApi	DeleteNodeBalancer	Delete /nodebalancers/{nodeBalancerId}	NodeBalancer Delete
NodeBalancersApi	DeleteNodeBalancerConfig	Delete /nodebalancers/{nodeBalancerId}/configs/{configId}	Config Delete
NodeBalancersApi	DeleteNodeBalancerConfigNode	Delete /nodebalancers/{nodeBalancerId}/configs/{configId}/nodes/{nodeId}	Node Delete
NodeBalancersApi	GetNodeBalancer	Get /nodebalancers/{nodeBalancerId}	NodeBalancer View
NodeBalancersApi	GetNodeBalancerConfig	Get /nodebalancers/{nodeBalancerId}/configs/{configId}	Config View
NodeBalancersApi	GetNodeBalancerConfigNodes	Get /nodebalancers/{nodeBalancerId}/configs/{configId}/nodes	Nodes List
NodeBalancersApi	GetNodeBalancerConfigs	Get /nodebalancers/{nodeBalancerId}/configs	Configs List
NodeBalancersApi	GetNodeBalancerNode	Get /nodebalancers/{nodeBalancerId}/configs/{configId}/nodes/{nodeId}	Node View
NodeBalancersApi	GetNodeBalancers	Get /nodebalancers	NodeBalancers List
NodeBalancersApi	NodebalancersNodeBalancerIdStatsGet	Get /nodebalancers/{nodeBalancerId}/stats	NodeBalancer Statistics View
NodeBalancersApi	RebuildNodeBalancerConfig	Post /nodebalancers/{nodeBalancerId}/configs/{configId}/rebuild	Config Rebuild
NodeBalancersApi	UpdateNodeBalancer	Put /nodebalancers/{nodeBalancerId}	NodeBalancer Update
NodeBalancersApi	UpdateNodeBalancerConfig	Put /nodebalancers/{nodeBalancerId}/configs/{configId}	Config Update
NodeBalancersApi	UpdateNodeBalancerNode	Put /nodebalancers/{nodeBalancerId}/configs/{configId}/nodes/{nodeId}	Node Update
ObjectStorageApi	CancelObjectStorage	Post /object-storage/cancel	Object Storage Cancel
ObjectStorageApi	CreateObjectStorageBucket	Post /object-storage/buckets	Object Storage Bucket Create
ObjectStorageApi	CreateObjectStorageKeys	Post /object-storage/keys	Object Storage Key Create
ObjectStorageApi	CreateObjectStorageObjectURL	Post /object-storage/buckets/{clusterId}/{bucket}/object-url	Object Storage Object URL Create
ObjectStorageApi	CreateObjectStorageSSL	Post /object-storage/buckets/{clusterId}/{bucket}/ssl	Object Storage TLS/SSL Cert Upload
ObjectStorageApi	DeleteObjectStorageBucket	Delete /object-storage/buckets/{clusterId}/{bucket}	Object Storage Bucket Remove
ObjectStorageApi	DeleteObjectStorageKey	Delete /object-storage/keys/{keyId}	Object Storage Key Revoke
ObjectStorageApi	DeleteObjectStorageSSL	Delete /object-storage/buckets/{clusterId}/{bucket}/ssl	Object Storage TLS/SSL Cert Delete
ObjectStorageApi	GetObjectStorageBucket	Get /object-storage/buckets/{clusterId}/{bucket}	Object Storage Bucket View
ObjectStorageApi	GetObjectStorageBucketContent	Get /object-storage/buckets/{clusterId}/{bucket}/object-list	Object Storage Bucket Contents List
ObjectStorageApi	GetObjectStorageBucketinCluster	Get /object-storage/buckets/{clusterId}	Object Storage Buckets in Cluster List
ObjectStorageApi	GetObjectStorageBuckets	Get /object-storage/buckets	Object Storage Buckets List
ObjectStorageApi	GetObjectStorageCluster	Get /object-storage/clusters/{clusterId}	Cluster View
ObjectStorageApi	GetObjectStorageClusters	Get /object-storage/clusters	Clusters List
ObjectStorageApi	GetObjectStorageKey	Get /object-storage/keys/{keyId}	Object Storage Key View
ObjectStorageApi	GetObjectStorageKeys	Get /object-storage/keys	Object Storage Keys List
ObjectStorageApi	GetObjectStorageSSL	Get /object-storage/buckets/{clusterId}/{bucket}/ssl	Object Storage TLS/SSL Cert View
ObjectStorageApi	GetObjectStorageTransfer	Get /object-storage/transfer	Object Storage Transfer View
ObjectStorageApi	ModifyObjectStorageBucketAccess	Post /object-storage/buckets/{clusterId}/{bucket}/access	Object Storage Bucket Access Modify
ObjectStorageApi	UpdateObjectStorageBucketACL	Put /object-storage/buckets/{clusterId}/{bucket}/object-acl	Object Storage Object ACL Config Update
ObjectStorageApi	UpdateObjectStorageBucketAccess	Put /object-storage/buckets/{clusterId}/{bucket}/access	Object Storage Bucket Access Update
ObjectStorageApi	UpdateObjectStorageKey	Put /object-storage/keys/{keyId}	Object Storage Key Update
ObjectStorageApi	ViewObjectStorageBucketACL	Get /object-storage/buckets/{clusterId}/{bucket}/object-acl	Object Storage Object ACL Config View
ProfileApi	AddSSHKey	Post /profile/sshkeys	SSH Key Add
ProfileApi	CreatePersonalAccessToken	Post /profile/tokens	Personal Access Token Create
ProfileApi	DeletePersonalAccessToken	Delete /profile/tokens/{tokenId}	Personal Access Token Revoke
ProfileApi	DeleteProfileApp	Delete /profile/apps/{appId}	App Access Revoke
ProfileApi	DeleteSSHKey	Delete /profile/sshkeys/{sshKeyId}	SSH Key Delete
ProfileApi	GetDevices	Get /profile/devices	Trusted Devices List
ProfileApi	GetPersonalAccessToken	Get /profile/tokens/{tokenId}	Personal Access Token View
ProfileApi	GetPersonalAccessTokens	Get /profile/tokens	Personal Access Tokens List
ProfileApi	GetProfile	Get /profile	Profile View
ProfileApi	GetProfileApp	Get /profile/apps/{appId}	Authorized App View
ProfileApi	GetProfileApps	Get /profile/apps	Authorized Apps List
ProfileApi	GetProfileGrants	Get /profile/grants	Grants List
ProfileApi	GetProfileLogin	Get /profile/logins/{loginId}	Login View
ProfileApi	GetProfileLogins	Get /profile/logins	Logins List
ProfileApi	GetSSHKey	Get /profile/sshkeys/{sshKeyId}	SSH Key View
ProfileApi	GetSSHKeys	Get /profile/sshkeys	SSH Keys List
ProfileApi	GetTrustedDevice	Get /profile/devices/{deviceId}	Trusted Device View
ProfileApi	GetUserPreferences	Get /profile/preferences	User Preferences View
ProfileApi	RevokeTrustedDevice	Delete /profile/devices/{deviceId}	Trusted Device Revoke
ProfileApi	TfaConfirm	Post /profile/tfa-enable-confirm	Two Factor Authentication Confirm/Enable
ProfileApi	TfaDisable	Post /profile/tfa-disable	Two Factor Authentication Disable
ProfileApi	TfaEnable	Post /profile/tfa-enable	Two Factor Secret Create
ProfileApi	UpdatePersonalAccessToken	Put /profile/tokens/{tokenId}	Personal Access Token Update
ProfileApi	UpdateProfile	Put /profile	Profile Update
ProfileApi	UpdateSSHKey	Put /profile/sshkeys/{sshKeyId}	SSH Key Update
ProfileApi	UpdateUserPreferences	Put /profile/preferences	User Preferences Update
RegionsApi	GetRegion	Get /regions/{regionId}	Region View
RegionsApi	GetRegions	Get /regions	Regions List
StackScriptsApi	AddStackScript	Post /linode/stackscripts	StackScript Create
StackScriptsApi	DeleteStackScript	Delete /linode/stackscripts/{stackscriptId}	StackScript Delete
StackScriptsApi	GetStackScript	Get /linode/stackscripts/{stackscriptId}	StackScript View
StackScriptsApi	GetStackScripts	Get /linode/stackscripts	StackScripts List
StackScriptsApi	UpdateStackScript	Put /linode/stackscripts/{stackscriptId}	StackScript Update
SupportApi	CloseTicket	Post /support/tickets/{ticketId}/close	Support Ticket Close
SupportApi	CreateTicket	Post /support/tickets	Support Ticket Open
SupportApi	CreateTicketAttachment	Post /support/tickets/{ticketId}/attachments	Ticket Attachment Create
SupportApi	CreateTicketReply	Post /support/tickets/{ticketId}/replies	Reply Create
SupportApi	GetTicket	Get /support/tickets/{ticketId}	Support Ticket View
SupportApi	GetTicketReplies	Get /support/tickets/{ticketId}/replies	Replies List
SupportApi	GetTickets	Get /support/tickets	Support Tickets List
TagsApi	CreateTag	Post /tags	New Tag Create
TagsApi	DeleteTag	Delete /tags/{label}	Tag Delete
TagsApi	GetTaggedObjects	Get /tags/{label}	Tagged Objects List
TagsApi	GetTags	Get /tags	Tags List
VolumesApi	AttachVolume	Post /volumes/{volumeId}/attach	Volume Attach
VolumesApi	CloneVolume	Post /volumes/{volumeId}/clone	Volume Clone
VolumesApi	CreateVolume	Post /volumes	Volume Create
VolumesApi	DeleteVolume	Delete /volumes/{volumeId}	Volume Delete
VolumesApi	DetachVolume	Post /volumes/{volumeId}/detach	Volume Detach
VolumesApi	GetVolume	Get /volumes/{volumeId}	Volume View
VolumesApi	GetVolumes	Get /volumes	Volumes List
VolumesApi	ResizeVolume	Post /volumes/{volumeId}/resize	Volume Resize
VolumesApi	UpdateVolume	Put /volumes/{volumeId}	Volume Update

Documentation For Models

Documentation For Authorization

oauth

Type: OAuth
Flow: accessCode
Authorization URL: https://login.linode.com/oauth/authorize
Scopes:
account:read_only: Allows access to GET information about your Account.
account:read_write: Allows access to all endpoints related to your Account.
domains:read_only: Allows access to GET Domains on your Account.
domains:read_write: Allows access to all Domain endpoints.
events:read_only: Allows access to GET your Events.
events:read_write: Allows access to all endpoints related to your Events.
firewall:read_only: Allows access to GET information about your Firewalls.
firewall:read_write: Allows acces to all Firewall endpoints.
images:read_only: Allows access to GET your Images.
images:read_write: Allows access to all endpoints related to your Images.
ips:read_only: Allows access to GET your ips.
ips:read_write: Allows access to all endpoints related to your ips.
linodes:read_only: Allows access to GET Linodes on your Account.
linodes:read_write: Allow access to all endpoints related to your Linodes.
lke:read_only: Allows access to GET LKE Clusters on your Account.
lke:read_write: Allows access to all endpoints related to LKE Clusters on your Account.
longview:read_only: Allows access to GET your Longview Clients.
longview:read_write: Allows access to all endpoints related to your Longview Clients.
maintenance:read_only: Allows access to GET information about Maintenance on your account.
nodebalancers:read_only: Allows access to GET NodeBalancers on your Account.
nodebalancers:read_write: Allows access to all NodeBalancer endpoints.
object_storage:read_only: Allows access to GET information related to your Object Storage.
object_storage:read_write: Allows access to all Object Storage endpoints.
stackscripts:read_only: Allows access to GET your StackScripts.
stackscripts:read_write: Allows access to all endpoints related to your StackScripts.
volumes:read_only: Allows access to GET your Volumes.
volumes:read_write: Allows access to all endpoints related to your Volumes.

Example

auth := context.WithValue(context.Background(), sw.ContextAccessToken, "ACCESSTOKENSTRING")
r, err := client.Service.Operation(auth, args)

Or via OAuth2 module to automatically refresh tokens and perform user authentication.

import "golang.org/x/oauth2"

/* Perform OAuth2 round trip request and obtain a token */

tokenSource := oauth2cfg.TokenSource(createContext(httpClient), &token)
auth := context.WithValue(oauth2.NoContext, sw.ContextOAuth2, tokenSource)
r, err := client.Service.Operation(auth, args)

personalAccessToken

Type: HTTP Bearer token authentication