# Images ## Create `client.gpuDroplets.images.create(ImageCreateParamsbody, RequestOptionsoptions?): ImageCreateResponse` **post** `/v2/images` To create a new custom image, send a POST request to /v2/images. The body must contain a url attribute pointing to a Linux virtual machine image to be imported into DigitalOcean. The image must be in the raw, qcow2, vhdx, vdi, or vmdk format. It may be compressed using gzip or bzip2 and must be smaller than 100 GB after being decompressed. ### Parameters - `body: ImageCreateParams` - `description?: string` An optional free-form text field to describe an image. - `distribution?: "Arch Linux" | "CentOS" | "CoreOS" | 10 more` The name of a custom image's distribution. Currently, the valid values are `Arch Linux`, `CentOS`, `CoreOS`, `Debian`, `Fedora`, `Fedora Atomic`, `FreeBSD`, `Gentoo`, `openSUSE`, `RancherOS`, `Rocky Linux`, `Ubuntu`, and `Unknown`. Any other value will be accepted but ignored, and `Unknown` will be used in its place. - `"Arch Linux"` - `"CentOS"` - `"CoreOS"` - `"Debian"` - `"Fedora"` - `"Fedora Atomic"` - `"FreeBSD"` - `"Gentoo"` - `"openSUSE"` - `"RancherOS"` - `"Rocky Linux"` - `"Ubuntu"` - `"Unknown"` - `name?: string` The display name that has been given to an image. This is what is shown in the control panel and is generally a descriptive title for the image in question. - `region?: "ams1" | "ams2" | "ams3" | 12 more` The slug identifier for the region where the resource will initially be available. - `"ams1"` - `"ams2"` - `"ams3"` - `"blr1"` - `"fra1"` - `"lon1"` - `"nyc1"` - `"nyc2"` - `"nyc3"` - `"sfo1"` - `"sfo2"` - `"sfo3"` - `"sgp1"` - `"tor1"` - `"syd1"` - `tags?: Array | null` A flat array of tag names as strings to be applied to the resource. Tag names may be for either existing or new tags.

Requires `tag:create` scope. - `url?: string` A URL from which the custom Linux virtual machine image may be retrieved. The image it points to must be in the raw, qcow2, vhdx, vdi, or vmdk format. It may be compressed using gzip or bzip2 and must be smaller than 100 GB after being decompressed. ### Returns - `ImageCreateResponse` - `image?: Image` - `id?: number` A unique number that can be used to identify and reference a specific image. - `created_at?: string` A time value given in ISO8601 combined date and time format that represents when the image was created. - `description?: string` An optional free-form text field to describe an image. - `distribution?: "Arch Linux" | "CentOS" | "CoreOS" | 10 more` The name of a custom image's distribution. Currently, the valid values are `Arch Linux`, `CentOS`, `CoreOS`, `Debian`, `Fedora`, `Fedora Atomic`, `FreeBSD`, `Gentoo`, `openSUSE`, `RancherOS`, `Rocky Linux`, `Ubuntu`, and `Unknown`. Any other value will be accepted but ignored, and `Unknown` will be used in its place. - `"Arch Linux"` - `"CentOS"` - `"CoreOS"` - `"Debian"` - `"Fedora"` - `"Fedora Atomic"` - `"FreeBSD"` - `"Gentoo"` - `"openSUSE"` - `"RancherOS"` - `"Rocky Linux"` - `"Ubuntu"` - `"Unknown"` - `error_message?: string` A string containing information about errors that may occur when importing a custom image. - `min_disk_size?: number | null` The minimum disk size in GB required for a Droplet to use this image. - `name?: string` The display name that has been given to an image. This is what is shown in the control panel and is generally a descriptive title for the image in question. - `public?: boolean` This is a boolean value that indicates whether the image in question is public or not. An image that is public is available to all accounts. A non-public image is only accessible from your account. - `regions?: Array<"ams1" | "ams2" | "ams3" | 12 more>` This attribute is an array of the regions that the image is available in. The regions are represented by their identifying slug values. - `"ams1"` - `"ams2"` - `"ams3"` - `"blr1"` - `"fra1"` - `"lon1"` - `"nyc1"` - `"nyc2"` - `"nyc3"` - `"sfo1"` - `"sfo2"` - `"sfo3"` - `"sgp1"` - `"tor1"` - `"syd1"` - `size_gigabytes?: number | null` The size of the image in gigabytes. - `slug?: string | null` A uniquely identifying string that is associated with each of the DigitalOcean-provided public images. These can be used to reference a public image as an alternative to the numeric id. - `status?: "NEW" | "available" | "pending" | 2 more` A status string indicating the state of a custom image. This may be `NEW`, `available`, `pending`, `deleted`, or `retired`. - `"NEW"` - `"available"` - `"pending"` - `"deleted"` - `"retired"` - `tags?: Array | null` A flat array of tag names as strings to be applied to the resource. Tag names may be for either existing or new tags.

Requires `tag:create` scope. - `type?: "base" | "snapshot" | "backup" | 2 more` Describes the kind of image. It may be one of `base`, `snapshot`, `backup`, `custom`, or `admin`. Respectively, this specifies whether an image is a DigitalOcean base OS image, user-generated Droplet snapshot, automatically created Droplet backup, user-provided virtual machine image, or an image used for DigitalOcean managed resources (e.g. DOKS worker nodes). - `"base"` - `"snapshot"` - `"backup"` - `"custom"` - `"admin"` ### Example ```typescript import Gradient from '@digitalocean/gradient'; const client = new Gradient(); const image = await client.gpuDroplets.images.create(); console.log(image.image); ``` ## Retrieve `client.gpuDroplets.images.retrieve(number | stringimageID, RequestOptionsoptions?): ImageRetrieveResponse` **get** `/v2/images/{image_id}` To retrieve information about an image, send a `GET` request to `/v2/images/$IDENTIFIER`. ### Parameters - `imageID: number | string` - `number` - `string` ### Returns - `ImageRetrieveResponse` - `image: Image` - `id?: number` A unique number that can be used to identify and reference a specific image. - `created_at?: string` A time value given in ISO8601 combined date and time format that represents when the image was created. - `description?: string` An optional free-form text field to describe an image. - `distribution?: "Arch Linux" | "CentOS" | "CoreOS" | 10 more` The name of a custom image's distribution. Currently, the valid values are `Arch Linux`, `CentOS`, `CoreOS`, `Debian`, `Fedora`, `Fedora Atomic`, `FreeBSD`, `Gentoo`, `openSUSE`, `RancherOS`, `Rocky Linux`, `Ubuntu`, and `Unknown`. Any other value will be accepted but ignored, and `Unknown` will be used in its place. - `"Arch Linux"` - `"CentOS"` - `"CoreOS"` - `"Debian"` - `"Fedora"` - `"Fedora Atomic"` - `"FreeBSD"` - `"Gentoo"` - `"openSUSE"` - `"RancherOS"` - `"Rocky Linux"` - `"Ubuntu"` - `"Unknown"` - `error_message?: string` A string containing information about errors that may occur when importing a custom image. - `min_disk_size?: number | null` The minimum disk size in GB required for a Droplet to use this image. - `name?: string` The display name that has been given to an image. This is what is shown in the control panel and is generally a descriptive title for the image in question. - `public?: boolean` This is a boolean value that indicates whether the image in question is public or not. An image that is public is available to all accounts. A non-public image is only accessible from your account. - `regions?: Array<"ams1" | "ams2" | "ams3" | 12 more>` This attribute is an array of the regions that the image is available in. The regions are represented by their identifying slug values. - `"ams1"` - `"ams2"` - `"ams3"` - `"blr1"` - `"fra1"` - `"lon1"` - `"nyc1"` - `"nyc2"` - `"nyc3"` - `"sfo1"` - `"sfo2"` - `"sfo3"` - `"sgp1"` - `"tor1"` - `"syd1"` - `size_gigabytes?: number | null` The size of the image in gigabytes. - `slug?: string | null` A uniquely identifying string that is associated with each of the DigitalOcean-provided public images. These can be used to reference a public image as an alternative to the numeric id. - `status?: "NEW" | "available" | "pending" | 2 more` A status string indicating the state of a custom image. This may be `NEW`, `available`, `pending`, `deleted`, or `retired`. - `"NEW"` - `"available"` - `"pending"` - `"deleted"` - `"retired"` - `tags?: Array | null` A flat array of tag names as strings to be applied to the resource. Tag names may be for either existing or new tags.

Requires `tag:create` scope. - `type?: "base" | "snapshot" | "backup" | 2 more` Describes the kind of image. It may be one of `base`, `snapshot`, `backup`, `custom`, or `admin`. Respectively, this specifies whether an image is a DigitalOcean base OS image, user-generated Droplet snapshot, automatically created Droplet backup, user-provided virtual machine image, or an image used for DigitalOcean managed resources (e.g. DOKS worker nodes). - `"base"` - `"snapshot"` - `"backup"` - `"custom"` - `"admin"` ### Example ```typescript import Gradient from '@digitalocean/gradient'; const client = new Gradient(); const image = await client.gpuDroplets.images.retrieve(0); console.log(image.image); ``` ## Update `client.gpuDroplets.images.update(numberimageID, ImageUpdateParamsbody, RequestOptionsoptions?): ImageUpdateResponse` **put** `/v2/images/{image_id}` To update an image, send a `PUT` request to `/v2/images/$IMAGE_ID`. Set the `name` attribute to the new value you would like to use. For custom images, the `description` and `distribution` attributes may also be updated. ### Parameters - `imageID: number` - `body: ImageUpdateParams` - `description?: string` An optional free-form text field to describe an image. - `distribution?: "Arch Linux" | "CentOS" | "CoreOS" | 10 more` The name of a custom image's distribution. Currently, the valid values are `Arch Linux`, `CentOS`, `CoreOS`, `Debian`, `Fedora`, `Fedora Atomic`, `FreeBSD`, `Gentoo`, `openSUSE`, `RancherOS`, `Rocky Linux`, `Ubuntu`, and `Unknown`. Any other value will be accepted but ignored, and `Unknown` will be used in its place. - `"Arch Linux"` - `"CentOS"` - `"CoreOS"` - `"Debian"` - `"Fedora"` - `"Fedora Atomic"` - `"FreeBSD"` - `"Gentoo"` - `"openSUSE"` - `"RancherOS"` - `"Rocky Linux"` - `"Ubuntu"` - `"Unknown"` - `name?: string` The display name that has been given to an image. This is what is shown in the control panel and is generally a descriptive title for the image in question. ### Returns - `ImageUpdateResponse` - `image: Image` - `id?: number` A unique number that can be used to identify and reference a specific image. - `created_at?: string` A time value given in ISO8601 combined date and time format that represents when the image was created. - `description?: string` An optional free-form text field to describe an image. - `distribution?: "Arch Linux" | "CentOS" | "CoreOS" | 10 more` The name of a custom image's distribution. Currently, the valid values are `Arch Linux`, `CentOS`, `CoreOS`, `Debian`, `Fedora`, `Fedora Atomic`, `FreeBSD`, `Gentoo`, `openSUSE`, `RancherOS`, `Rocky Linux`, `Ubuntu`, and `Unknown`. Any other value will be accepted but ignored, and `Unknown` will be used in its place. - `"Arch Linux"` - `"CentOS"` - `"CoreOS"` - `"Debian"` - `"Fedora"` - `"Fedora Atomic"` - `"FreeBSD"` - `"Gentoo"` - `"openSUSE"` - `"RancherOS"` - `"Rocky Linux"` - `"Ubuntu"` - `"Unknown"` - `error_message?: string` A string containing information about errors that may occur when importing a custom image. - `min_disk_size?: number | null` The minimum disk size in GB required for a Droplet to use this image. - `name?: string` The display name that has been given to an image. This is what is shown in the control panel and is generally a descriptive title for the image in question. - `public?: boolean` This is a boolean value that indicates whether the image in question is public or not. An image that is public is available to all accounts. A non-public image is only accessible from your account. - `regions?: Array<"ams1" | "ams2" | "ams3" | 12 more>` This attribute is an array of the regions that the image is available in. The regions are represented by their identifying slug values. - `"ams1"` - `"ams2"` - `"ams3"` - `"blr1"` - `"fra1"` - `"lon1"` - `"nyc1"` - `"nyc2"` - `"nyc3"` - `"sfo1"` - `"sfo2"` - `"sfo3"` - `"sgp1"` - `"tor1"` - `"syd1"` - `size_gigabytes?: number | null` The size of the image in gigabytes. - `slug?: string | null` A uniquely identifying string that is associated with each of the DigitalOcean-provided public images. These can be used to reference a public image as an alternative to the numeric id. - `status?: "NEW" | "available" | "pending" | 2 more` A status string indicating the state of a custom image. This may be `NEW`, `available`, `pending`, `deleted`, or `retired`. - `"NEW"` - `"available"` - `"pending"` - `"deleted"` - `"retired"` - `tags?: Array | null` A flat array of tag names as strings to be applied to the resource. Tag names may be for either existing or new tags.

Requires `tag:create` scope. - `type?: "base" | "snapshot" | "backup" | 2 more` Describes the kind of image. It may be one of `base`, `snapshot`, `backup`, `custom`, or `admin`. Respectively, this specifies whether an image is a DigitalOcean base OS image, user-generated Droplet snapshot, automatically created Droplet backup, user-provided virtual machine image, or an image used for DigitalOcean managed resources (e.g. DOKS worker nodes). - `"base"` - `"snapshot"` - `"backup"` - `"custom"` - `"admin"` ### Example ```typescript import Gradient from '@digitalocean/gradient'; const client = new Gradient(); const image = await client.gpuDroplets.images.update(62137902); console.log(image.image); ``` ## List `client.gpuDroplets.images.list(ImageListParamsquery?, RequestOptionsoptions?): ImageListResponse` **get** `/v2/images` To list all of the images available on your account, send a GET request to /v2/images. ## Filtering Results --- It's possible to request filtered results by including certain query parameters. **Image Type** Either 1-Click Application or OS Distribution images can be filtered by using the `type` query parameter. > Important: The `type` query parameter does not directly relate to the `type` attribute. To retrieve only ***distribution*** images, include the `type` query parameter set to distribution, `/v2/images?type=distribution`. To retrieve only ***application*** images, include the `type` query parameter set to application, `/v2/images?type=application`. **User Images** To retrieve only the private images of a user, include the `private` query parameter set to true, `/v2/images?private=true`. **Tags** To list all images assigned to a specific tag, include the `tag_name` query parameter set to the name of the tag in your GET request. For example, `/v2/images?tag_name=$TAG_NAME`. ### Parameters - `query: ImageListParams` - `page?: number` Which 'page' of paginated results to return. - `per_page?: number` Number of items returned per page - `_private?: boolean` Used to filter only user images. - `tag_name?: string` Used to filter images by a specific tag. - `type?: "application" | "distribution"` Filters results based on image type which can be either `application` or `distribution`. - `"application"` - `"distribution"` ### Returns - `ImageListResponse` - `images: Array` - `id?: number` A unique number that can be used to identify and reference a specific image. - `created_at?: string` A time value given in ISO8601 combined date and time format that represents when the image was created. - `description?: string` An optional free-form text field to describe an image. - `distribution?: "Arch Linux" | "CentOS" | "CoreOS" | 10 more` The name of a custom image's distribution. Currently, the valid values are `Arch Linux`, `CentOS`, `CoreOS`, `Debian`, `Fedora`, `Fedora Atomic`, `FreeBSD`, `Gentoo`, `openSUSE`, `RancherOS`, `Rocky Linux`, `Ubuntu`, and `Unknown`. Any other value will be accepted but ignored, and `Unknown` will be used in its place. - `"Arch Linux"` - `"CentOS"` - `"CoreOS"` - `"Debian"` - `"Fedora"` - `"Fedora Atomic"` - `"FreeBSD"` - `"Gentoo"` - `"openSUSE"` - `"RancherOS"` - `"Rocky Linux"` - `"Ubuntu"` - `"Unknown"` - `error_message?: string` A string containing information about errors that may occur when importing a custom image. - `min_disk_size?: number | null` The minimum disk size in GB required for a Droplet to use this image. - `name?: string` The display name that has been given to an image. This is what is shown in the control panel and is generally a descriptive title for the image in question. - `public?: boolean` This is a boolean value that indicates whether the image in question is public or not. An image that is public is available to all accounts. A non-public image is only accessible from your account. - `regions?: Array<"ams1" | "ams2" | "ams3" | 12 more>` This attribute is an array of the regions that the image is available in. The regions are represented by their identifying slug values. - `"ams1"` - `"ams2"` - `"ams3"` - `"blr1"` - `"fra1"` - `"lon1"` - `"nyc1"` - `"nyc2"` - `"nyc3"` - `"sfo1"` - `"sfo2"` - `"sfo3"` - `"sgp1"` - `"tor1"` - `"syd1"` - `size_gigabytes?: number | null` The size of the image in gigabytes. - `slug?: string | null` A uniquely identifying string that is associated with each of the DigitalOcean-provided public images. These can be used to reference a public image as an alternative to the numeric id. - `status?: "NEW" | "available" | "pending" | 2 more` A status string indicating the state of a custom image. This may be `NEW`, `available`, `pending`, `deleted`, or `retired`. - `"NEW"` - `"available"` - `"pending"` - `"deleted"` - `"retired"` - `tags?: Array | null` A flat array of tag names as strings to be applied to the resource. Tag names may be for either existing or new tags.

Requires `tag:create` scope. - `type?: "base" | "snapshot" | "backup" | 2 more` Describes the kind of image. It may be one of `base`, `snapshot`, `backup`, `custom`, or `admin`. Respectively, this specifies whether an image is a DigitalOcean base OS image, user-generated Droplet snapshot, automatically created Droplet backup, user-provided virtual machine image, or an image used for DigitalOcean managed resources (e.g. DOKS worker nodes). - `"base"` - `"snapshot"` - `"backup"` - `"custom"` - `"admin"` - `meta: MetaProperties` Information about the response itself. - `total?: number` Number of objects returned by the request. - `links?: PageLinks` - `pages?: ForwardLinks | BackwardLinks | unknown` - `ForwardLinks` - `last?: string` URI of the last page of the results. - `next?: string` URI of the next page of the results. - `BackwardLinks` - `first?: string` URI of the first page of the results. - `prev?: string` URI of the previous page of the results. - `unknown` ### Example ```typescript import Gradient from '@digitalocean/gradient'; const client = new Gradient(); const images = await client.gpuDroplets.images.list(); console.log(images.images); ``` ## Delete `client.gpuDroplets.images.delete(numberimageID, RequestOptionsoptions?): void` **delete** `/v2/images/{image_id}` To delete a snapshot or custom image, send a `DELETE` request to `/v2/images/$IMAGE_ID`. ### Parameters - `imageID: number` ### Example ```typescript import Gradient from '@digitalocean/gradient'; const client = new Gradient(); await client.gpuDroplets.images.delete(62137902); ``` # Actions ## Create `client.gpuDroplets.images.actions.create(numberimageID, ActionCreateParamsbody, RequestOptionsoptions?): Action` **post** `/v2/images/{image_id}/actions` The following actions are available on an Image. ## Convert an Image to a Snapshot To convert an image, for example, a backup to a snapshot, send a POST request to `/v2/images/$IMAGE_ID/actions`. Set the `type` attribute to `convert`. ## Transfer an Image To transfer an image to another region, send a POST request to `/v2/images/$IMAGE_ID/actions`. Set the `type` attribute to `transfer` and set `region` attribute to the slug identifier of the region you wish to transfer to. ### Parameters - `imageID: number` - `ActionCreateParams = ImageActionBase | ImageActionTransfer` - `ActionCreateParamsBase` - `type: "convert" | "transfer"` The action to be taken on the image. Can be either `convert` or `transfer`. - `"convert"` - `"transfer"` - `ImageActionBase extends ActionCreateParamsBase` - `ImageActionTransfer extends ActionCreateParamsBase` ### Returns - `Action` - `id?: number` A unique numeric ID that can be used to identify and reference an action. - `completed_at?: string | null` A time value given in ISO8601 combined date and time format that represents when the action was completed. - `region?: Region` - `available: boolean` This is a boolean value that represents whether new Droplets can be created in this region. - `features: Array` This attribute is set to an array which contains features available in this region - `name: string` The display name of the region. This will be a full name that is used in the control panel and other interfaces. - `sizes: Array` This attribute is set to an array which contains the identifying slugs for the sizes available in this region. sizes:read is required to view. - `slug: string` A human-readable string that is used as a unique identifier for each region. - `region_slug?: string | null` A human-readable string that is used as a unique identifier for each region. - `resource_id?: number | null` A unique identifier for the resource that the action is associated with. - `resource_type?: string` The type of resource that the action is associated with. - `started_at?: string` A time value given in ISO8601 combined date and time format that represents when the action was initiated. - `status?: "in-progress" | "completed" | "errored"` The current status of the action. This can be "in-progress", "completed", or "errored". - `"in-progress"` - `"completed"` - `"errored"` - `type?: string` This is the type of action that the object represents. For example, this could be "transfer" to represent the state of an image transfer action. ### Example ```typescript import Gradient from '@digitalocean/gradient'; const client = new Gradient(); const action = await client.gpuDroplets.images.actions.create(62137902, { type: 'convert' }); console.log(action.id); ``` ## Retrieve `client.gpuDroplets.images.actions.retrieve(numberactionID, ActionRetrieveParamsparams, RequestOptionsoptions?): Action` **get** `/v2/images/{image_id}/actions/{action_id}` To retrieve the status of an image action, send a GET request to `/v2/images/$IMAGE_ID/actions/$IMAGE_ACTION_ID`. ### Parameters - `actionID: number` - `params: ActionRetrieveParams` - `image_id: number` A unique number that can be used to identify and reference a specific image. ### Returns - `Action` - `id?: number` A unique numeric ID that can be used to identify and reference an action. - `completed_at?: string | null` A time value given in ISO8601 combined date and time format that represents when the action was completed. - `region?: Region` - `available: boolean` This is a boolean value that represents whether new Droplets can be created in this region. - `features: Array` This attribute is set to an array which contains features available in this region - `name: string` The display name of the region. This will be a full name that is used in the control panel and other interfaces. - `sizes: Array` This attribute is set to an array which contains the identifying slugs for the sizes available in this region. sizes:read is required to view. - `slug: string` A human-readable string that is used as a unique identifier for each region. - `region_slug?: string | null` A human-readable string that is used as a unique identifier for each region. - `resource_id?: number | null` A unique identifier for the resource that the action is associated with. - `resource_type?: string` The type of resource that the action is associated with. - `started_at?: string` A time value given in ISO8601 combined date and time format that represents when the action was initiated. - `status?: "in-progress" | "completed" | "errored"` The current status of the action. This can be "in-progress", "completed", or "errored". - `"in-progress"` - `"completed"` - `"errored"` - `type?: string` This is the type of action that the object represents. For example, this could be "transfer" to represent the state of an image transfer action. ### Example ```typescript import Gradient from '@digitalocean/gradient'; const client = new Gradient(); const action = await client.gpuDroplets.images.actions.retrieve(36804636, { image_id: 62137902 }); console.log(action.id); ``` ## List `client.gpuDroplets.images.actions.list(numberimageID, RequestOptionsoptions?): ActionListResponse` **get** `/v2/images/{image_id}/actions` To retrieve all actions that have been executed on an image, send a GET request to `/v2/images/$IMAGE_ID/actions`. ### Parameters - `imageID: number` ### Returns - `ActionListResponse` - `meta: MetaProperties` Information about the response itself. - `total?: number` Number of objects returned by the request. - `actions?: Array` - `id?: number` A unique numeric ID that can be used to identify and reference an action. - `completed_at?: string | null` A time value given in ISO8601 combined date and time format that represents when the action was completed. - `region?: Region` - `available: boolean` This is a boolean value that represents whether new Droplets can be created in this region. - `features: Array` This attribute is set to an array which contains features available in this region - `name: string` The display name of the region. This will be a full name that is used in the control panel and other interfaces. - `sizes: Array` This attribute is set to an array which contains the identifying slugs for the sizes available in this region. sizes:read is required to view. - `slug: string` A human-readable string that is used as a unique identifier for each region. - `region_slug?: string | null` A human-readable string that is used as a unique identifier for each region. - `resource_id?: number | null` A unique identifier for the resource that the action is associated with. - `resource_type?: string` The type of resource that the action is associated with. - `started_at?: string` A time value given in ISO8601 combined date and time format that represents when the action was initiated. - `status?: "in-progress" | "completed" | "errored"` The current status of the action. This can be "in-progress", "completed", or "errored". - `"in-progress"` - `"completed"` - `"errored"` - `type?: string` This is the type of action that the object represents. For example, this could be "transfer" to represent the state of an image transfer action. - `links?: PageLinks` - `pages?: ForwardLinks | BackwardLinks | unknown` - `ForwardLinks` - `last?: string` URI of the last page of the results. - `next?: string` URI of the next page of the results. - `BackwardLinks` - `first?: string` URI of the first page of the results. - `prev?: string` URI of the previous page of the results. - `unknown` ### Example ```typescript import Gradient from '@digitalocean/gradient'; const client = new Gradient(); const actions = await client.gpuDroplets.images.actions.list(62137902); console.log(actions.meta); ```