Images

Images List

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

Returns a paginated list of Images.

  • Public Images have IDs that begin with "linode/". These distribution images are generally available to all users.

  • Private Images have IDs that begin with "private/". These Images are Account-specific and only accessible to Users with appropriate Grants.

  • To view only public Images, call this endpoint with or without authentication. To view private Images as well, call this endpoint with authentication.

Query Parameters

page
integer > = 1
Default: 1

The page of a collection to return.

page_size
integer [25 .. 500]
Default: 100

The number of items to return per page.

Request Samples

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

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/images

Response Samples

{
  "data": [
    {
      "id": "",
      "created": "2021-08-14T22:44:02",
      "status": "available",
      "label": "Debian 11",
      "type": "manual",
      "updated": "2021-08-14T22:44:02",
      "expiry": "",
      "description": "Example Image description.",
      "created_by": "linode",
      "deprecated": "",
      "is_public": true,
      "size": 2500,
      "eol": "2026-07-01T04:00:00",
      "vendor": "Debian",
      "capabilities": [
        "cloud-init"
      ]
    }
  ],
  "page": 1,
  "pages": 1,
  "results": 1
}

Responses

200: A paginated list of Images.

data
array of objects
id
string

The unique ID of this Image.

created
string

When this Image was created.

status
Filterable
string
Enum: "creating""pending_upload""available"

The current status of this Image.

Only Images in an "available" status can be deployed. Images in a "creating" status are being created from a Linode Disk, and will become "available" shortly. Images in a "pending_upload" status are waiting for data to be uploaded, and become "available" after the upload and processing are complete.

The "+order_by" and "+order" operators are not available for filtering on this key.

label
Filterable
string

A short description of the Image.

type
Filterable
string
Enum: "manual""automatic"

How the Image was created.

"Manual" Images can be created at any time.

"Automatic" Images are created automatically from a deleted Linode.

updated
string

When this Image was last updated.

expiry
Nullable
string

Only Images created automatically from a deleted Linode (type=automatic) will expire.

description
Nullable
string

A detailed description of this Image.

created_by
string

The name of the User who created this Image, or "linode" for public Images.

deprecated
Filterable
boolean

Whether or not this Image is deprecated. Will only be true for deprecated public Images.

is_public
Filterable
boolean

True if the Image is a public distribution image. False if Image is private Account-specific Image.

size
Filterable
integer

The minimum size this Image needs to deploy. Size is in MB.

eol
string

The date of the public Image's planned end of life. None for private Images.

vendor
Filterable
string

The upstream distribution vendor. None for private Images.

capabilities
array

A list containing the following possible capabilities of this Image:

cloud-init: This Image supports cloud-init with Metadata. Only applies to public Images.

page
integer

The current page.

pages
integer

The total number of pages.

results
integer

The total number of results.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.

Image Create

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

Captures a private gold-master Image from a Linode Disk.

Request Body Schema

disk_id
Required
integer

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

description
string

A detailed description of this Image.

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

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X POST -d '{
      "disk_id": 123,
      "label": "this_is_a_label",
      "description": "A longer description of the image"
    }' \
    https://api.linode.com/v4/images

Response Samples

{
  "status": "available",
  "created": "2021-08-14T22:44:02",
  "updated": "2021-08-14T22:44:02",
  "expiry": "",
  "id": 1234,
  "label": "Debian 11",
  "description": "Example Image description.",
  "type": "manual",
  "created_by": "linode",
  "deprecated": "",
  "is_public": true,
  "size": 2500,
  "eol": "2026-07-01T04:00:00",
  "vendor": "Debian",
  "capabilities": []
}

Responses

200: New private Image created successfully.

status
Filterable
string
Enum: "creating""pending_upload""available"

The current status of this Image.

Only Images in an "available" status can be deployed. Images in a "creating" status are being created from a Linode Disk, and will become "available" shortly. Images in a "pending_upload" status are waiting for data to be uploaded, and become "available" after the upload and processing are complete.

The "+order_by" and "+order" operators are not available for filtering on this key.

created
string <date-time>

When this Image was created.

updated
string <date-time>

When this Image was last updated.

expiry
Nullable
string <date-time>

Only Images created automatically from a deleted Linode (type=automatic) will expire.

id
string

The unique ID of this Image.

label
Filterable
string

A short description of the Image.

description
Nullable
string [1 .. 65000] characters

A detailed description of this Image.

type
Filterable
string
Enum: "manual""automatic"

How the Image was created.

"Manual" Images can be created at any time.

"Automatic" Images are created automatically from a deleted Linode.

created_by
string

The name of the User who created this Image, or "linode" for public Images.

deprecated
Filterable
boolean

Whether or not this Image is deprecated. Will only be true for deprecated public Images.

is_public
Filterable
boolean

True if the Image is a public distribution image. False if Image is private Account-specific Image.

size
Filterable
integer

The minimum size this Image needs to deploy. Size is in MB.

eol
string <date-time>

The date of the public Image's planned end of life. None for private Images.

vendor
Filterable
string

The upstream distribution vendor. None for private Images.

capabilities
array of objects

A list containing the following possible capabilities of this Image:

cloud-init: This Image supports cloud-init with Metadata. Only applies to public Images.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.