Skip to content
  • Auto
  • Light
  • Dark

Shared

Shared

ModelsExpand Collapse
class Action:
id: Optional[int]

A unique numeric ID that can be used to identify and reference an action.

completed_at: Optional[datetime]

A time value given in ISO8601 combined date and time format that represents when the action was completed.

formatdate-time
region: Optional[Region]
region_slug: Optional[str]

A human-readable string that is used as a unique identifier for each region.

resource_id: Optional[int]

A unique identifier for the resource that the action is associated with.

resource_type: Optional[str]

The type of resource that the action is associated with.

started_at: Optional[datetime]

A time value given in ISO8601 combined date and time format that represents when the action was initiated.

formatdate-time
status: Optional[Literal["in-progress", "completed", "errored"]]

The current status of the action. This can be "in-progress", "completed", or "errored".

Accepts one of the following:
"in-progress"
"completed"
"errored"
type: Optional[str]

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.

The linked actions can be used to check the status of a Droplet's create event.

A unique numeric ID that can be used to identify and reference an action.

A URL that can be used to access the action.

formaturi

A string specifying the type of the related action.

Links to other pages

Information about how to reach other pages

First page

Last page

Next page

Previous page

class APIMeta:

Meta information about the data set

page: Optional[int]

The current page

formatint64
pages: Optional[int]

Total number of pages

formatint64
total: Optional[int]

Total amount of items over all pages

formatint64

URI of the first page of the results.

URI of the previous page of the results.

class ChatCompletionChunk:

Represents a streamed chunk of a chat completion response returned by the model, based on the provided input.

id: str

A unique identifier for the chat completion. Each chunk has the same ID.

choices: List[Choice]

A list of chat completion choices. Can contain more than one elements if n is greater than 1. Can also be empty for the last chunk if you set stream_options: {"include_usage": true}.

delta: ChoiceDelta

A chat completion delta generated by streamed model responses.

content: Optional[str]

The contents of the chunk message.

refusal: Optional[str]

The refusal message generated by the model.

role: Optional[Literal["developer", "user", "assistant"]]

The role of the author of this message.

Accepts one of the following:
"developer"
"user"
"assistant"
tool_calls: Optional[List[ChoiceDeltaToolCall]]
index: int
id: Optional[str]

The ID of the tool call.

function: Optional[ChoiceDeltaToolCallFunction]

A chunk of a function that the model called.

arguments: Optional[str]

The arguments to call the function with, as generated by the model in JSON format. Note that the model does not always generate valid JSON, and may hallucinate parameters not defined by your function schema. Validate the arguments in your code before calling your function.

name: Optional[str]

The name of the function to call.

type: Optional[Literal["function"]]

The type of the tool. Currently, only function is supported.

Accepts one of the following:
"function"
finish_reason: Optional[Literal["stop", "length", "tool_calls"]]

The reason the model stopped generating tokens. This will be stop if the model hit a natural stop point or a provided stop sequence, or length if the maximum number of tokens specified in the request was reached, tool_calls if the model called a tool.

Accepts one of the following:
"stop"
"length"
"tool_calls"
index: int

The index of the choice in the list of choices.

logprobs: Optional[ChoiceLogprobs]

Log probability information for the choice.

content: Optional[List[ChatCompletionTokenLogprob]]

A list of message content tokens with log probability information.

token: str

The token.

bytes: Optional[List[int]]

A list of integers representing the UTF-8 bytes representation of the token. Useful in instances where characters are represented by multiple tokens and their byte representations must be combined to generate the correct text representation. Can be null if there is no bytes representation for the token.

logprob: float

The log probability of this token, if it is within the top 20 most likely tokens. Otherwise, the value -9999.0 is used to signify that the token is very unlikely.

top_logprobs: List[TopLogprob]

List of the most likely tokens and their log probability, at this token position. In rare cases, there may be fewer than the number of requested top_logprobs returned.

token: str

The token.

bytes: Optional[List[int]]

A list of integers representing the UTF-8 bytes representation of the token. Useful in instances where characters are represented by multiple tokens and their byte representations must be combined to generate the correct text representation. Can be null if there is no bytes representation for the token.

logprob: float

The log probability of this token, if it is within the top 20 most likely tokens. Otherwise, the value -9999.0 is used to signify that the token is very unlikely.

refusal: Optional[List[ChatCompletionTokenLogprob]]

A list of message refusal tokens with log probability information.

token: str

The token.

bytes: Optional[List[int]]

A list of integers representing the UTF-8 bytes representation of the token. Useful in instances where characters are represented by multiple tokens and their byte representations must be combined to generate the correct text representation. Can be null if there is no bytes representation for the token.

logprob: float

The log probability of this token, if it is within the top 20 most likely tokens. Otherwise, the value -9999.0 is used to signify that the token is very unlikely.

top_logprobs: List[TopLogprob]

List of the most likely tokens and their log probability, at this token position. In rare cases, there may be fewer than the number of requested top_logprobs returned.

token: str

The token.

bytes: Optional[List[int]]

A list of integers representing the UTF-8 bytes representation of the token. Useful in instances where characters are represented by multiple tokens and their byte representations must be combined to generate the correct text representation. Can be null if there is no bytes representation for the token.

logprob: float

The log probability of this token, if it is within the top 20 most likely tokens. Otherwise, the value -9999.0 is used to signify that the token is very unlikely.

created: int

The Unix timestamp (in seconds) of when the chat completion was created. Each chunk has the same timestamp.

model: str

The model to generate the completion.

object: Literal["chat.completion.chunk"]

The object type, which is always chat.completion.chunk.

Accepts one of the following:
"chat.completion.chunk"
usage: Optional[CompletionUsage]

An optional field that will only be present when you set stream_options: {"include_usage": true} in your request. When present, it contains a null value except for the last chunk which contains the token usage statistics for the entire request.

NOTE: If the stream is interrupted or cancelled, you may not receive the final usage chunk which contains the total token usage for the request.

class ChatCompletionTokenLogprob:
token: str

The token.

bytes: Optional[List[int]]

A list of integers representing the UTF-8 bytes representation of the token. Useful in instances where characters are represented by multiple tokens and their byte representations must be combined to generate the correct text representation. Can be null if there is no bytes representation for the token.

logprob: float

The log probability of this token, if it is within the top 20 most likely tokens. Otherwise, the value -9999.0 is used to signify that the token is very unlikely.

top_logprobs: List[TopLogprob]

List of the most likely tokens and their log probability, at this token position. In rare cases, there may be fewer than the number of requested top_logprobs returned.

token: str

The token.

bytes: Optional[List[int]]

A list of integers representing the UTF-8 bytes representation of the token. Useful in instances where characters are represented by multiple tokens and their byte representations must be combined to generate the correct text representation. Can be null if there is no bytes representation for the token.

logprob: float

The log probability of this token, if it is within the top 20 most likely tokens. Otherwise, the value -9999.0 is used to signify that the token is very unlikely.

class CompletionUsage:

Usage statistics for the completion request.

completion_tokens: int

Number of tokens in the generated completion.

prompt_tokens: int

Number of tokens in the prompt.

total_tokens: int

Total number of tokens used in the request (prompt + completion).

class DiskInfo:
size: Optional[Size]
amount: Optional[int]

The amount of space allocated to the disk.

unit: Optional[str]

The unit of measure for the disk size.

type: Optional[Literal["local", "scratch"]]

The type of disk. All Droplets contain a local disk. Additionally, GPU Droplets can also have a scratch disk for non-persistent data.

Accepts one of the following:
"local"
"scratch"
class Droplet:
id: int

A unique identifier for each Droplet instance. This is automatically generated upon Droplet creation.

backup_ids: List[int]

An array of backup IDs of any backups that have been taken of the Droplet instance. Droplet backups are enabled at the time of the instance creation.
Requires image:read scope.

created_at: datetime

A time value given in ISO8601 combined date and time format that represents when the Droplet was created.

formatdate-time
disk: int

The size of the Droplet's disk in gigabytes.

features: List[str]

An array of features enabled on this Droplet.

image: Image

The Droplet's image.
Requires image:read scope.

locked: bool

A boolean value indicating whether the Droplet has been locked, preventing actions by users.

memory: int

Memory of the Droplet in megabytes.

multipleOf8
name: str

The human-readable name set for the Droplet instance.

networks: Networks

The details of the network that are configured for the Droplet instance. This is an object that contains keys for IPv4 and IPv6. The value of each of these is an array that contains objects describing an individual IP resource allocated to the Droplet. These will define attributes like the IP address, netmask, and gateway of the specific network depending on the type of network it is.

v4: Optional[List[NetworkV4]]
gateway: Optional[str]

The gateway of the specified IPv4 network interface.

For private interfaces, a gateway is not provided. This is denoted by returning nil as its value.

ip_address: Optional[str]

The IP address of the IPv4 network interface.

formatipv4
netmask: Optional[str]

The netmask of the IPv4 network interface.

formatipv4
type: Optional[Literal["public", "private"]]

The type of the IPv4 network interface.

Accepts one of the following:
"public"
"private"
v6: Optional[List[NetworkV6]]
gateway: Optional[str]

The gateway of the specified IPv6 network interface.

formatipv6
ip_address: Optional[str]

The IP address of the IPv6 network interface.

formatipv6
netmask: Optional[int]

The netmask of the IPv6 network interface.

type: Optional[Literal["public"]]

The type of the IPv6 network interface.

Note: IPv6 private networking is not currently supported.

Accepts one of the following:
"public"
next_backup_window: Optional[DropletNextBackupWindow]

The details of the Droplet's backups feature, if backups are configured for the Droplet. This object contains keys for the start and end times of the window during which the backup will start.

region: Region
size: Size
size_slug: str

The unique slug identifier for the size of this Droplet.

snapshot_ids: List[int]

An array of snapshot IDs of any snapshots created from the Droplet instance.
Requires image:read scope.

status: Literal["new", "active", "off", "archive"]

A status string indicating the state of the Droplet instance. This may be "new", "active", "off", or "archive".

Accepts one of the following:
"new"
"active"
"off"
"archive"
tags: List[str]

An array of Tags the Droplet has been tagged with.
Requires tag:read scope.

vcpus: int

The number of virtual CPUs.

volume_ids: List[str]

A flat array including the unique identifier for each Block Storage volume attached to the Droplet.
Requires block_storage:read scope.

disk_info: Optional[List[DiskInfo]]

An array of objects containing information about the disks available to the Droplet.

size: Optional[Size]
amount: Optional[int]

The amount of space allocated to the disk.

unit: Optional[str]

The unit of measure for the disk size.

type: Optional[Literal["local", "scratch"]]

The type of disk. All Droplets contain a local disk. Additionally, GPU Droplets can also have a scratch disk for non-persistent data.

Accepts one of the following:
"local"
"scratch"
gpu_info: Optional[GPUInfo]

An object containing information about the GPU capabilities of Droplets created with this size.

Deprecatedkernel: Optional[Kernel]

Note: All Droplets created after March 2017 use internal kernels by default. These Droplets will have this attribute set to null.

The current kernel for Droplets with externally managed kernels. This will initially be set to the kernel of the base image when the Droplet is created.

vpc_uuid: Optional[str]

A string specifying the UUID of the VPC to which the Droplet is assigned.
Requires vpc:read scope.

class DropletNextBackupWindow:
end: Optional[datetime]

A time value given in ISO8601 combined date and time format specifying the end of the Droplet's backup window.

formatdate-time
start: Optional[datetime]

A time value given in ISO8601 combined date and time format specifying the start of the Droplet's backup window.

formatdate-time
class FirewallRuleTarget:
addresses: Optional[List[str]]

An array of strings containing the IPv4 addresses, IPv6 addresses, IPv4 CIDRs, and/or IPv6 CIDRs to which the firewall will allow traffic.

droplet_ids: Optional[List[int]]

An array containing the IDs of the Droplets to which the firewall will allow traffic.

kubernetes_ids: Optional[List[str]]

An array containing the IDs of the Kubernetes clusters to which the firewall will allow traffic.

load_balancer_uids: Optional[List[str]]

An array containing the IDs of the load balancers to which the firewall will allow traffic.

tags: Optional[List[str]]

A flat array of tag names as strings to be applied to the resource. Tag names must exist in order to be referenced in a request.

Requires tag:create and tag:read scopes.

URI of the last page of the results.

URI of the next page of the results.

class GarbageCollection:
blobs_deleted: Optional[int]

The number of blobs deleted as a result of this garbage collection.

created_at: Optional[datetime]

The time the garbage collection was created.

formatdate-time
freed_bytes: Optional[int]

The number of bytes freed as a result of this garbage collection.

registry_name: Optional[str]

The name of the container registry.

status: Optional[Literal["requested", "waiting for write JWTs to expire", "scanning manifests", 5 more]]

The current status of this garbage collection.

Accepts one of the following:
"requested"
"waiting for write JWTs to expire"
"scanning manifests"
"deleting unreferenced blobs"
"cancelling"
"failed"
"succeeded"
"cancelled"
updated_at: Optional[datetime]

The time the garbage collection was last updated.

formatdate-time
uuid: Optional[str]

A string specifying the UUID of the garbage collection.

class GPUInfo:

An object containing information about the GPU capabilities of Droplets created with this size.

count: Optional[int]

The number of GPUs allocated to the Droplet.

model: Optional[str]

The model of the GPU.

vram: Optional[Vram]
amount: Optional[int]

The amount of VRAM allocated to the GPU.

unit: Optional[str]

The unit of measure for the VRAM.

class Image:
id: Optional[int]

A unique number that can be used to identify and reference a specific image.

created_at: Optional[datetime]

A time value given in ISO8601 combined date and time format that represents when the image was created.

formatdate-time
description: Optional[str]

An optional free-form text field to describe an image.

distribution: Optional[Literal["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.

Accepts one of the following:
"Arch Linux"
"CentOS"
"CoreOS"
"Debian"
"Fedora"
"Fedora Atomic"
"FreeBSD"
"Gentoo"
"openSUSE"
"RancherOS"
"Rocky Linux"
"Ubuntu"
"Unknown"
error_message: Optional[str]

A string containing information about errors that may occur when importing a custom image.

min_disk_size: Optional[int]

The minimum disk size in GB required for a Droplet to use this image.

minimum0
name: Optional[str]

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: Optional[bool]

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: Optional[List[Literal["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.

Accepts one of the following:
"ams1"
"ams2"
"ams3"
"blr1"
"fra1"
"lon1"
"nyc1"
"nyc2"
"nyc3"
"sfo1"
"sfo2"
"sfo3"
"sgp1"
"tor1"
"syd1"
size_gigabytes: Optional[float]

The size of the image in gigabytes.

formatfloat
slug: Optional[str]

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: Optional[Literal["NEW", "available", "pending", 2 more]]

A status string indicating the state of a custom image. This may be NEW, available, pending, deleted, or retired.

Accepts one of the following:
"NEW"
"available"
"pending"
"deleted"
"retired"
tags: Optional[List[str]]

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: Optional[Literal["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).

Accepts one of the following:
"base"
"snapshot"
"backup"
"custom"
"admin"
class Kernel:

Note: All Droplets created after March 2017 use internal kernels by default. These Droplets will have this attribute set to null.

The current kernel for Droplets with externally managed kernels. This will initially be set to the kernel of the base image when the Droplet is created.

id: Optional[int]

A unique number used to identify and reference a specific kernel.

name: Optional[str]

The display name of the kernel. This is shown in the web UI and is generally a descriptive title for the kernel in question.

version: Optional[str]

A standard kernel version string representing the version, patch, and release information.

class MetaProperties:

Information about the response itself.

total: Optional[int]

Number of objects returned by the request.

class NetworkV4:
gateway: Optional[str]

The gateway of the specified IPv4 network interface.

For private interfaces, a gateway is not provided. This is denoted by returning nil as its value.

ip_address: Optional[str]

The IP address of the IPv4 network interface.

formatipv4
netmask: Optional[str]

The netmask of the IPv4 network interface.

formatipv4
type: Optional[Literal["public", "private"]]

The type of the IPv4 network interface.

Accepts one of the following:
"public"
"private"
class NetworkV6:
gateway: Optional[str]

The gateway of the specified IPv6 network interface.

formatipv6
ip_address: Optional[str]

The IP address of the IPv6 network interface.

formatipv6
netmask: Optional[int]

The netmask of the IPv6 network interface.

type: Optional[Literal["public"]]

The type of the IPv6 network interface.

Note: IPv6 private networking is not currently supported.

Accepts one of the following:
"public"
class Region:
available: bool

This is a boolean value that represents whether new Droplets can be created in this region.

features: List[str]

This attribute is set to an array which contains features available in this region

name: str

The display name of the region. This will be a full name that is used in the control panel and other interfaces.

sizes: List[str]

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: str

A human-readable string that is used as a unique identifier for each region.

class Size:
available: bool

This is a boolean value that represents whether new Droplets can be created with this size.

description: str

A string describing the class of Droplets created from this size. For example: Basic, General Purpose, CPU-Optimized, Memory-Optimized, or Storage-Optimized.

disk: int

The amount of disk space set aside for Droplets of this size. The value is represented in gigabytes.

memory: int

The amount of RAM allocated to Droplets created of this size. The value is represented in megabytes.

multipleOf8
minimum8
price_hourly: float

This describes the price of the Droplet size as measured hourly. The value is measured in US dollars.

formatfloat
price_monthly: float

This attribute describes the monthly cost of this Droplet size if the Droplet is kept for an entire month. The value is measured in US dollars.

formatfloat
regions: List[str]

An array containing the region slugs where this size is available for Droplet creates. regions:read is required to view.

slug: str

A human-readable string that is used to uniquely identify each size.

transfer: float

The amount of transfer bandwidth that is available for Droplets created in this size. This only counts traffic on the public interface. The value is given in terabytes.

formatfloat
vcpus: int

The number of CPUs allocated to Droplets of this size.

disk_info: Optional[List[DiskInfo]]

An array of objects containing information about the disks available to Droplets created with this size.

size: Optional[Size]
amount: Optional[int]

The amount of space allocated to the disk.

unit: Optional[str]

The unit of measure for the disk size.

type: Optional[Literal["local", "scratch"]]

The type of disk. All Droplets contain a local disk. Additionally, GPU Droplets can also have a scratch disk for non-persistent data.

Accepts one of the following:
"local"
"scratch"
gpu_info: Optional[GPUInfo]

An object containing information about the GPU capabilities of Droplets created with this size.

class Snapshots:
id: str

The unique identifier for the snapshot.

created_at: datetime

A time value given in ISO8601 combined date and time format that represents when the snapshot was created.

formatdate-time
min_disk_size: int

The minimum size in GB required for a volume or Droplet to use this snapshot.

name: str

A human-readable name for the snapshot.

regions: List[str]

An array of the regions that the snapshot is available in. The regions are represented by their identifying slug values.

resource_id: str

The unique identifier for the resource that the snapshot originated from.

resource_type: Literal["droplet", "volume"]

The type of resource that the snapshot originated from.

Accepts one of the following:
"droplet"
"volume"
size_gigabytes: float

The billable size of the snapshot in gigabytes.

formatfloat
tags: Optional[List[str]]

An array of Tags the snapshot has been tagged with.

Requires tag:read scope.

class Subscription:
created_at: Optional[datetime]

The time at which the subscription was created.

formatdate-time
tier: Optional[SubscriptionTierBase]
updated_at: Optional[datetime]

The time at which the subscription was last updated.

formatdate-time
class SubscriptionTierBase:
allow_storage_overage: Optional[bool]

A boolean indicating whether the subscription tier supports additional storage above what is included in the base plan at an additional cost per GiB used.

included_bandwidth_bytes: Optional[int]

The amount of outbound data transfer included in the subscription tier in bytes.

included_repositories: Optional[int]

The number of repositories included in the subscription tier. 0 indicates that the subscription tier includes unlimited repositories.

included_storage_bytes: Optional[int]

The amount of storage included in the subscription tier in bytes.

monthly_price_in_cents: Optional[int]

The monthly cost of the subscription tier in cents.

name: Optional[str]

The name of the subscription tier.

slug: Optional[str]

The slug identifier of the subscription tier.

storage_overage_price_in_cents: Optional[int]

The price paid in cents per GiB for additional storage beyond what is included in the subscription plan.

class VpcPeering:
id: Optional[str]

A unique ID that can be used to identify and reference the VPC peering.

formatuuid
created_at: Optional[datetime]

A time value given in ISO8601 combined date and time format.

formatdate-time
name: Optional[str]

The name of the VPC peering. Must be unique within the team and may only contain alphanumeric characters and dashes.

status: Optional[Literal["PROVISIONING", "ACTIVE", "DELETING"]]

The current status of the VPC peering.

Accepts one of the following:
"PROVISIONING"
"ACTIVE"
"DELETING"
vpc_ids: Optional[List[str]]

An array of the two peered VPCs IDs.