Skip to main content
DigitalOcean logo
  • Category: developer tools
  • Auth: API_KEY, OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 55
  • Triggers: 0
  • Slug: DIGITAL_OCEAN
  • Version: 20261101_00

Tools

Slug: DIGITAL_OCEAN_CREATE_CUSTOM_IMAGECreates a custom image in DigitalOcean by importing a Linux VM disk image from a publicly accessible URL. Use this action to upload custom OS images (Ubuntu, Debian, CentOS, Fedora, etc.) that can later be used to create Droplets. The image will be processed asynchronously and its status can be monitored via the returned image ID.

Input Parameters

string
required
Publicly accessible URL (HTTP/HTTPS) pointing to a Linux VM disk image. Supported formats: Raw (.img), qcow2, VHDX, VDI, VMDK. May be compressed with gzip or bzip2.
string
required
A human-readable name for the custom image (e.g., ‘ubuntu-20.04-webserver’).
array
Optional list of tag strings for organizing and categorizing the image.
string
required
DigitalOcean region slug where the image will be initially stored (e.g., ‘nyc1’, ‘nyc3’, ‘sfo2’, ‘sfo3’, ‘lon1’, ‘ams3’).
string
Optional detailed description of the image’s purpose, contents, or configuration.
string
required
Operating system distribution name. Valid options: ‘Ubuntu’, ‘Debian’, ‘CentOS’, ‘Fedora’, ‘Arch Linux’, or ‘Unknown’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_DATABASE_CLUSTERCreates a new managed database cluster on DigitalOcean. Provisions a database with specified engine (PostgreSQL, MySQL, Valkey, MongoDB, Kafka, or OpenSearch), version, region, size, and node count. Returns connection credentials and cluster details. The cluster will be in ‘creating’ status initially and take several minutes to become fully operational.

Input Parameters

string
required
Name for your database cluster
string
required
Size slug for the database nodes. Examples: db-s-1vcpu-1gb, db-s-2vcpu-4gb, gd-2vcpu-8gb
array
Tags to assign to the cluster
string ("pg" | "mysql" | "valkey" | "mongodb" | "kafka" | "opensearch")
required
Database engine type: ‘pg’ (PostgreSQL), ‘mysql’ (MySQL), ‘valkey’ (Redis-compatible), ‘mongodb’ (MongoDB), ‘kafka’ (Apache Kafka), ‘opensearch’ (OpenSearch)
string
required
Region slug where the cluster will be created. Examples: nyc1, nyc3, sfo3, lon1, fra1, ams3, sgp1, tor1, blr1
string
required
Database engine version. Examples: ‘16’ for PostgreSQL, ‘8’ for MySQL/Valkey, ‘8.0’ for MongoDB, ‘3.8’ for Kafka, ‘2’ for OpenSearch
array
Names of databases to create in the cluster
string
SQL mode for MySQL clusters
integer
required
Number of nodes in the cluster. Typical values: 1 (single node), 2 (primary + standby), 3 (high availability)
array
Usernames to create in the cluster
object
Configuration to restore a cluster from a backup
string
Eviction policy for Redis clusters
integer
Additional storage size in GiB for the cluster
object
Maintenance window configuration for the cluster
string
UUID of VPC network for private networking

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_BLOCK_STORAGE_VOLUMETool to create a new block storage volume. Use when you need to provision persistent block storage after confirming the target region supports volumes. Example: “Create a 100 GiB ext4 backup volume named ‘db-backup’ in nyc1.”

Input Parameters

string
required
A human-readable name for the block storage volume.
array
List of tags to apply to the volume.
string
required
Slug identifier for the region where the volume will be created (e.g., ‘nyc1’).
string
Free-form text description of the volume.
string
Unique identifier of a snapshot to create the volume from.
integer
required
Size of the block storage volume in GiB (minimum 1).
string
Filesystem type to initialize on the volume (e.g., ‘ext4’).
string
Label to apply to the filesystem.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_DOMAINCreates a new domain in DigitalOcean’s DNS management system. This adds the domain to your DigitalOcean account and allows you to manage its DNS records. Use this action when you need to: - Add a domain to DigitalOcean DNS for DNS hosting and management - Set up a new domain with an optional initial A record pointing to an IP address - Transfer DNS management of an existing domain to DigitalOcean Note: The domain name must be unique within your DigitalOcean account and use a recognized top-level domain (TLD). After creation, you can add additional DNS records using the create domain record action.

Input Parameters

string
required
The domain name to add to DigitalOcean DNS management (e.g., ‘example.com’). Must be a valid domain with a recognized TLD. The domain must be unique and not already exist in the account.
string
Optional IPv4 address to create an initial A record pointing the domain apex to this IP. If not provided, the domain will be created without any DNS records.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_DOMAIN_RECORDTool to create a new DNS record for a domain. Use after confirming domain exists and record specifics.

Input Parameters

string
Tag for CAA records (issue, issuewild, iodef); required if type is CAA
integer
Time to live for the record in seconds
string
required
Value of the DNS record. Format depends on the record type. For CAA records with issue/issuewild tags, use FQDN with trailing dot (e.g., ‘letsencrypt.org.’)
string
Host name for the record (e.g., ‘www’). Use ’@’ for root domain
integer
Port for SRV records; required if type is SRV
string ("A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS" | "SRV" | "CAA")
required
Type of DNS record to create
integer
Flags for CAA records; required if type is CAA
integer
Weight for SRV records; required if type is SRV
integer
Priority for MX and SRV records; required if type is MX or SRV
string
required
The domain name to add the record to, e.g., ‘example.com’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_DROPLETTool to create a new Droplet. Use when you need to provision a VM with name, region, size, and image. The image, region, and size must be mutually compatible — the chosen region must be listed in the image’s available regions.

Input Parameters

boolean
Whether IPv6 is enabled
string
required
A human-readable name for the Droplet
string
required
Size slug for the Droplet
array
List of tags to apply to the Droplet
string
required
Image slug or ID to use for the Droplet
string
required
Region slug where the Droplet will be created
boolean
Whether automatic backups are enabled
array
IDs of volumes to attach to the Droplet
array
List of SSH key IDs or fingerprints to embed
string
VPC UUID to assign the Droplet to
string
User data (cloud-init) script to configure the Droplet
boolean
Whether monitoring is enabled
boolean
Deprecated: use ‘vpc_uuid’ instead
boolean
Whether to install the Droplet agent for metrics

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_FIREWALLCreates a new cloud firewall with custom inbound and outbound rules. Use this action to set up network security rules that control traffic to and from your Droplets. You can specify rules using IP addresses (CIDR notation), Droplet IDs, tags, Load Balancer UUIDs, or Kubernetes cluster IDs. The firewall can be applied to specific Droplets, all Droplets with certain tags, or scoped to a VPC. Requires at least one inbound rule and one outbound rule. Supports tcp, udp, and icmp protocols.

Input Parameters

string
required
Name of the new firewall.
array
Optional list of Droplet tags to apply the firewall to matching droplets.
string
Optional VPC UUID to scope this firewall to a VPC.
array
Optional list of Droplet IDs to apply the firewall to.
array
required
List of inbound rules; must contain at least one.
array
required
List of outbound rules; must contain at least one.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_KUBERNETES_CLUSTERCreates a new DigitalOcean Kubernetes (DOKS) cluster with managed control plane. Required: cluster name, region slug, Kubernetes version slug, and at least one node pool configuration. Optional: tags, auto-upgrade settings, maintenance policy, node labels/taints, and auto-scaling. The cluster will be created in ‘provisioning’ state and may take several minutes to become ‘running’. Query /v2/kubernetes/options endpoint to get available regions, versions, and node sizes.

Input Parameters

string
required
A human-readable name for the Kubernetes cluster.
array
List of tags to apply to the cluster.
string
required
Region slug where the cluster will be created. Common regions: nyc1, nyc3, sfo3, lon1, fra1, tor1, blr1, sgp1, ams3, syd1.
string
required
Kubernetes version slug to deploy (e.g., ‘1.34.1-do.3’, ‘1.33.6-do.3’). Use /v2/kubernetes/options to get current available versions.
array
required
List of node pools; at least one required.
boolean
Whether to auto-upgrade to new patch releases.
object
Scheduled maintenance policy for the cluster.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_LOAD_BALANCERTool to create a new load balancer. Use after specifying region, forwarding rules, and targets.

Input Parameters

string
Tag to select droplets (mutually exclusive with droplet_ids).
string
required
Unique name for the new load balancer.
string
required
Region slug where the load balancer will be created (e.g., ‘nyc1’).
string
UUID of the VPC to assign the load balancer to.
string ("round_robin" | "least_connections")
Load balancing algorithm to use; defaults to ‘round_robin’.
array
List of droplet IDs to attach (mutually exclusive with tag).
object
Optional health check configuration.
string
ID of a custom firewall policy to apply.
object
Optional session persistence configuration.
array
required
List of forwarding rules mapping entry to target protocols and ports.
boolean
Enable PROXY protocol for backend connections.
boolean
Redirect HTTP traffic to HTTPS.
boolean
Enable keepalive connections to backend droplets.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_SSH_KEYRegisters a new SSH public key with your DigitalOcean account. The registered key can then be automatically added to new Droplets during creation, enabling secure SSH access. The key must be provided in OpenSSH format (ssh-rsa, ssh-ed25519, etc.) and must not already exist on the account.

Input Parameters

string
required
A human-readable name to identify the SSH key (e.g., ‘laptop-key’, ‘production-server’). This name helps you distinguish between multiple keys in your account.
string
required
The complete SSH public key string in OpenSSH format. Must start with the key type (ssh-rsa, ssh-ed25519, ecdsa-sha2-nistp256, etc.) followed by the base64-encoded key data and an optional comment. The key must be valid and not already registered on your account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_TAGCreates a new tag in DigitalOcean for organizing and grouping resources. Tags can be applied to droplets, images, volumes, volume snapshots, and databases. If a tag with the same name already exists, the API returns the existing tag (idempotent operation). Tag names must be 1-255 characters containing only letters, numbers, hyphens, or underscores.

Input Parameters

string
required
The name of the new tag. Must be 1-255 characters and only contain alphanumeric characters, hyphens (-), or underscores (_).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_CREATE_NEW_VPCCreates a new Virtual Private Cloud (VPC) in a specified DigitalOcean region. VPCs are private networks for isolating your resources. Traffic within a VPC is free and doesn’t count toward bandwidth limits. VPCs support Droplets, managed databases, load balancers, and Kubernetes clusters. The first VPC created in a region automatically becomes the default VPC for that region.

Input Parameters

string
required
The name of the VPC. Must be unique within your account.
array
List of tag names to apply to the VPC after creation.
string
required
Slug identifier for the region where the VPC will be created. Common regions include nyc3 (New York), sfo3 (San Francisco), lon1 (London), fra1 (Frankfurt), sgp1 (Singapore), tor1 (Toronto).
string
The IP range in CIDR notation for the VPC. Network size must be between /16 and /28. If not specified, DigitalOcean assigns a default range automatically. Must not overlap with any existing VPC IP ranges in your account.
string
A free-form description of the VPC.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_BLOCK_STORAGE_VOLUMEPermanently deletes a block storage volume by its unique ID; the volume must not be attached to a Droplet before deletion. A successful deletion returns an empty response.

Input Parameters

string
required
The unique identifier (UUID) of the block storage volume to delete. The volume must not be attached to any Droplet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_DATABASE_CLUSTERDeletes a database cluster by UUID. A successful deletion returns an empty response.

Input Parameters

string
required
The UUID of the database cluster to destroy

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_DOMAINDeletes a domain from DigitalOcean DNS permanently, returning an empty response on success. If it is associated with a Let’s Encrypt certificate, delete the certificate first and reconfigure resources using it.

Input Parameters

string
required
The fully qualified domain name to delete, e.g., ‘example.com’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_DOMAIN_RECORDDeletes a DNS record by its record ID and domain name. A successful deletion returns an empty response.

Input Parameters

string
required
The domain name (e.g., ‘example.com’).
integer
required
The unique identifier of the DNS record to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_EXISTING_DROPLETTool to delete a Droplet by ID. Deletion is irreversible — all data is permanently lost. Confirm droplet_id with the user and verify a backup or snapshot exists before proceeding.

Input Parameters

integer
required
Unique identifier of the Droplet to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_FIREWALLTool to delete a firewall by ID. Use when you have confirmed the firewall is no longer needed.

Input Parameters

string
required
Unique identifier of the firewall to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_IMAGEDeletes a user-created custom image or snapshot from your DigitalOcean account by its numeric ID. This action permanently removes the image and cannot be undone. Only custom images and snapshots you own can be deleted - attempting to delete distribution images or marketplace applications will fail with a 403 Forbidden error. Use this when cleaning up unused images that are no longer needed and have no dependent resources.

Input Parameters

integer
required
The unique numeric ID of the custom image or snapshot to delete. Note: Only user-created custom images and snapshots can be deleted. DigitalOcean distribution images and marketplace application images cannot be deleted and will return a 403 Forbidden error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_LOAD_BALANCERDeletes a load balancer by ID. A successful deletion returns an empty response.

Input Parameters

string
required
Unique identifier of the load balancer to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_SSH_KEYDeletes a public SSH key from the account by ID or fingerprint. A successful deletion returns an empty response.

Input Parameters

string
required
The identifier for the SSH key (numeric ID or fingerprint).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_TAGDeletes a tag from your DigitalOcean account. When a tag is deleted, it is automatically removed from all resources that were tagged with it. This operation is idempotent - deleting a non-existent tag will also return success (204 No Content).

Input Parameters

string
required
The name of the tag to delete; all resources with this tag will be untagged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_DELETE_VPCDelete a VPC (Virtual Private Cloud) by its unique identifier. Use this tool when you need to permanently remove a VPC from your DigitalOcean account. Deletion is irreversible — always confirm the vpc_id with the user before proceeding. Important Restrictions: - Cannot delete a VPC that is the default VPC for its region - Cannot delete a VPC that has member resources (droplets, databases, load balancers, etc.) — all resources must be detached or migrated first - VPC must be empty before deletion Returns an empty response (HTTP 204) on successful deletion.

Input Parameters

string
required
Unique identifier of the VPC to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_GET_ACCOUNTRetrieve the authenticated account’s profile, status, team, and resource limits.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_GET_ACTIONRetrieve a DigitalOcean action by ID to inspect its status and metadata.

Input Parameters

integer
required
The unique numeric ID of the DigitalOcean action to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_GET_CUSTOMER_BALANCERetrieve current and month-to-date billing balances for the customer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_GET_DROPLET_METRICSRetrieve a bandwidth, CPU, filesystem, load, or memory time series.

Input Parameters

string
required
Unix timestamp for the end of the metric window.
string
required
Unix timestamp for the beginning of the metric window.
string ("bandwidth" | "cpu" | "filesystem_free" | "filesystem_size" | "load_1" | "load_5" | "load_15" | "memory_available" | "memory_cached" | "memory_free" | "memory_total")
required
Metric time series to retrieve for the Droplet.
string
required
The numeric Droplet ID, supplied as a string.
string ("inbound" | "outbound")
Traffic direction for bandwidth metrics. Required when metric is bandwidth.
string ("private" | "public")
Network interface for bandwidth metrics. Required when metric is bandwidth.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_DATABASESTool to list all managed database clusters on your account. Supports pagination and filtering by tag. A single request returns only one page; iterate using page and per_page to retrieve all clusters.

Input Parameters

integer
Page number to retrieve (starting from 1).
integer
Number of items to return per page. Must be between 1 and 200.
string
Filter to return only database clusters with this tag name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_DOMAINSLists all DNS domains configured in your DigitalOcean account. Returns domain names, TTL values, and complete zone files. Supports pagination for large domain lists. Use this action to discover available domains, check domain configurations, or as a prerequisite for domain-specific operations like managing DNS records. No parameters are required - calling without parameters returns the first 20 domains (default page size).

Input Parameters

integer
Page number to retrieve (starting from 1).
integer
Number of domains to return per page (1-200). Default is 20 if omitted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_DROPLETSLists all Droplets (virtual machines) in your DigitalOcean account with pagination support. Returns detailed information including: ID, name, specs (memory, vCPUs, disk), status, networking (IP addresses), region, image, size, tags, and VPC. Supports filtering by tag and pagination for large result sets. Use this to get an overview of your infrastructure, find specific droplets, or monitor droplet status. Default page size is 20; accounts with more droplets require explicit pagination (increment page, up to per_page=200) to avoid silently incomplete results.

Input Parameters

integer
Page of results to return. Must be >= 1. Default is 1.
integer
Number of items per page. Must be between 1 and 200. Default is 20.
string
Filter droplets by tag name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_FIREWALLSList all cloud firewalls configured in your DigitalOcean account. Returns comprehensive firewall details including inbound/outbound rules, associated droplets, tags, and status. Supports pagination for accounts with many firewalls. Use this to audit network security, discover existing firewall configurations, or retrieve firewall IDs for subsequent operations.

Input Parameters

integer
Page number to retrieve (starting from 1).
integer
Number of firewalls to return per page (1-200).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_IMAGESTool to list all images available on your account. Use after obtaining a valid API token to retrieve images optionally filtered by type, private visibility, or tag_name.

Input Parameters

integer
Page number to return. Default: 1. Minimum: 1.
string ("distribution" | "application" | "private")
Filter images by type. Valid values: ‘distribution’, ‘application’, ‘private’.
boolean
If true, returns only private images. Defaults to false.
integer
Number of results per page. Default: 20. Range: 1-200.
string
Return only images tagged with this tag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_KUBERNETES_CLUSTERSTool to list all Kubernetes clusters on your account. Use when you need to enumerate every cluster and handle pagination.

Input Parameters

integer
Page number of paginated results (starting from 1).
integer
Number of clusters per page. Must be between 1 and 200.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_LOAD_BALANCERSList all load balancers in your DigitalOcean account with pagination support. Returns load balancer details including IDs, names, IP addresses, forwarding rules, health checks, sticky sessions, assigned Droplets, and region information. Use this to get an overview of all load balancers or to find specific load balancers by iterating through results.

Input Parameters

integer
Page of results to return. Must be >= 1. Default is 1.
integer
Number of items per page. Must be between 1 and 200. Default is 20.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_SNAPSHOTSTool to list all snapshots available on your DigitalOcean account. Use when you need to fetch and optionally filter snapshots by resource type (droplet or volume) and handle pagination for inventory or backup workflows.

Input Parameters

integer
Page number to retrieve (starting from 1).
integer
Number of snapshots to return per page (1-200).
string ("droplet" | "volume")
Filter snapshots by resource type; either ‘droplet’ or ‘volume’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_SSH_KEYSLists all SSH keys associated with your DigitalOcean account. Returns SSH key details including ID, name, public key content, and fingerprint. Supports pagination for accounts with many SSH keys. Use this when you need to view available SSH keys or retrieve an SSH key ID for use with other operations like creating droplets.

Input Parameters

integer
Page number to retrieve (starting from 1). Use with per_page to navigate through paginated results. Omit to get the first page.
integer
Number of SSH keys to return per page (1-200). Omit to use DigitalOcean’s default page size. Use 200 to retrieve maximum results per request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_TAGSTool to list all tags in your account. Use when you need to retrieve available tags and pagination info. A single request returns only one page of results; iterate using page and per_page to retrieve all tags.

Input Parameters

integer
Page number to retrieve (starting from 1).
integer
Number of items returned per page. Must be between 1 and 200.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_VOLUMESTool to list all block storage volumes available on your account. Use when you need to retrieve volumes and optionally filter by name and region.

Input Parameters

string
Filter to return only volumes with this exact name.
integer
Page number to retrieve (starting from 1).
string
Filter to return only volumes in this region (region slug).
integer
Number of items returned per page. Must be between 1 and 200.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_ALL_VPCSTool to list all VPCs on your account. Use when you need an inventory of your VPC resources. A single request returns only one page; iterate through all pages using page and per_page (max 200) to retrieve the complete set.

Input Parameters

integer
Page number to retrieve (default: 1).
integer
Number of VPCs to return per page (default: 20, max: 200).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_APPSTool to list all App Platform apps in your DigitalOcean account. Use when you need to discover app IDs by name, retrieve app metadata, or enumerate all apps with pagination support.

Input Parameters

integer
Which ‘page’ of paginated results to return. Must be >= 1. Default is 1.
integer
Number of items returned per page. Must be between 1 and 200. Default is 20.
boolean
Whether the project_id of listed apps should be fetched and included in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_DATABASE_OPTIONSLists all available configuration options for DigitalOcean managed database clusters, including supported engines (PostgreSQL, MySQL, MongoDB, Valkey, Kafka, OpenSearch), versions, regions, and cluster sizes/layouts. Use this to discover valid parameter values when creating a new database cluster.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_DOMAIN_RECORDSTool to list all DNS records for a domain. Use when you need to inspect or filter a domain’s DNS configuration.

Input Parameters

integer
Page of results to return (>= 1).
string ("A" | "AAAA" | "CNAME" | "MX" | "NS" | "TXT" | "SRV" | "LOC" | "CAA")
Filter records by DNS record type.
integer
Number of results per page (1-200).
string
required
The domain name whose records are to be listed (e.g., ‘example.com’).
string
Filter records by record name (e.g., ‘www’, ’@’ for root domain).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_DROPLET_SIZESList Droplet size plans with pricing, capacity, and regional availability.

Input Parameters

integer
Page number to return, starting at 1. Default is 1.
integer
Number of sizes to return per page, from 1 to 200. Default is 20.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_LIST_RESERVED_IPSList reserved IPs; assigned Droplet details require droplet:read access.

Input Parameters

integer
Page number to return, starting at 1. Default is 1.
integer
Number of reserved IPs to return per page, from 1 to 200. Default is 20.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_RETRIEVE_DOMAINRetrieves complete details about a specific domain including its TTL and DNS zone file configuration. Use this when you need to check domain settings, verify DNS configuration, or get the full zone file contents for a domain in your DigitalOcean account.

Input Parameters

string
required
The fully qualified domain name (e.g., ‘example.com’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_RETRIEVE_DOMAIN_RECORDTool to retrieve a specific DNS record for a domain by its record ID. Use when you have the domain name and record ID to fetch record details.

Input Parameters

string
required
The domain name (e.g., ‘example.com’).
integer
required
The unique identifier for the DNS record.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_RETRIEVE_DROPLET_ACTIONRetrieve the current status and result metadata of one Droplet action.

Input Parameters

integer
required
Unique positive numeric identifier of the Droplet action.
integer
required
Unique positive numeric identifier of the Droplet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_RETRIEVE_EXISTING_DROPLETRetrieve detailed information about a specific DigitalOcean Droplet by its unique numeric ID. Returns comprehensive droplet details including: current status, specifications (memory, CPU, disk), networking configuration (IPv4/IPv6 addresses), image information, region, VPC, backup settings, attached volumes, and tags. Use this when you need to check a droplet’s current state, configuration, or IP addresses.

Input Parameters

integer
required
The unique numeric identifier of the Droplet you want to retrieve information about. You can obtain droplet IDs from the List All Droplets action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_RETRIEVE_EXISTING_IMAGETool to retrieve information about an image by ID or slug. Use when you need detailed metadata for a known image.

Input Parameters

string
required
The unique numeric ID or slug of the image to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_RETRIEVE_TAGRetrieve a tag by name, including resource counts by type and metadata about the most recently tagged resource of each type when available.

Input Parameters

string
required
The name of the tag to retrieve (case-sensitive).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_RETRIEVE_VPCTool to retrieve details about a specific VPC by its ID. Use when you need to inspect VPC properties for configuration or auditing.

Input Parameters

string
required
The unique identifier of the VPC.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_TAG_RESOURCEAssign an existing tag by name to one or more resources. On success, returns an empty response.

Input Parameters

string
required
The name of the tag to which resources will be assigned
array
required
List of resources to assign the tag to (each with id and type)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_UNTAG_RESOURCETool to untag resources by tag name. Use when you need to remove an existing tag from multiple resources in a single operation.

Input Parameters

string
required
Name of the tag to remove from the specified resources.
array
required
List of resource objects to untag, each with id, type, and optional region.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_UPDATE_DOMAIN_RECORDTool to update an existing DNS record for a domain. Use when you need to modify any valid attribute of a record after confirming its record ID.

Input Parameters

string
Tag for CAA records.
integer
Time to live of the record in seconds.
string
The value of the DNS record (e.g., IP address for A/AAAA record).
string
The host name for the record (e.g., ‘www’, ’@’).
integer
Port for SRV records.
string
The DNS record type (e.g., ‘A’, ‘CNAME’, ‘TXT’, ‘MX’, ‘SRV’, ‘CAA’).
integer
Flags for CAA records.
integer
Weight for SRV records.
integer
Priority for MX records.
integer
required
The unique identifier for the DNS record.
string
required
The domain name (e.g., ‘example.com’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DIGITAL_OCEAN_UPDATE_VPCTool to update information about a VPC. Use when you need to modify the name, description, or default status of an existing VPC.

Input Parameters

string
The new name for the VPC.
string
required
The unique identifier of the VPC to update.
boolean
Whether to set this VPC as the default for its region.
string
A free-form text description for the VPC.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not