Images v4.78.3

Images List

GET https://api.linode.com/v4/images

Returns a paginated list of Images.

  • Calling this endpoint without authentication returns all public Images.
  • Authentication is required to return a combined paginated list of all public and your private Images.

Authorizations

personalAccessToken
oauth images:read_only

Query Parameters

page
Type:
integer >= 1
Default:
1

The page of a collection to return.

page_size
Type:
integer 25..100
Default:
100

The number of items to return per page.

Request Samples

Response Samples

Responses

Image Create

POST https://api.linode.com/v4/images

Creates a private gold-master Image from a Linode Disk. There is no additional charge to store Images for Linode users. Images are limited to three per Account.

Authorizations

personalAccessToken
oauth images:read_write

Request Body Schema

description
string

A detailed description of this Image.

disk_id
Required
integer

The ID of the Linode Disk that this Image will be created from.

label
string

A short title of this Image. Defaults to the label of the Disk it is being created from if not provided.

Request Samples

Response Samples

Responses

Image Delete

DELETE https://api.linode.com/v4/images/{imageId}

Deletes a private Image you have permission to read_write.

Deleting an Image is a destructive action and cannot be undone.

Authorizations

personalAccessToken
oauth images:read_write

Path Parameters

imageId string Required

ID of the Image to look up.

Request Samples

Response Samples

Responses

Image View

GET https://api.linode.com/v4/images/{imageId}

Get information about a single Image.

Authorizations

Path Parameters

imageId string Required

ID of the Image to look up.

Request Samples

Response Samples

Responses

Image Update

PUT https://api.linode.com/v4/images/{imageId}

Updates a private Image that you have permission to read_write.

Authorizations

personalAccessToken
oauth images:read_write

Path Parameters

imageId string Required

ID of the Image to look up.

Request Body Schema

description
string

A detailed description of this Image.

label
Filterable
string

A short description of the Image. Labels cannot contain special characters.

Request Samples

Response Samples

Responses