Skip to main content
Every digitalocean.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.
New to Corsair? See API access, authentication, and error handling.

​
Databases

​
createDatabaseCluster

databases.createDatabaseCluster Creates 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. Risk: write
Input
Output: any

​
deleteDatabaseCluster

databases.deleteDatabaseCluster Tool to delete a database cluster by UUID. Use when you have confirmed the cluster is no longer needed. Returns HTTP 204 No Content on success. Risk: destructive · Irreversible
Input
Output: any

​
listAllDatabases

databases.listAllDatabases Tool 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. Risk: read
Input
Output: any

​
listDatabaseOptions

databases.listDatabaseOptions Lists 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 | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | data | string | Yes | Data from the action execution | | error | string | No | Error if any occurred during the execution of the action | | successful | boolean | Yes | Whether or not the action execution was successful or not | Risk: read
Input
Output: any

​
Domain Records

​
createNewDomainRecord

domainRecords.createNewDomainRecord Tool to create a new DNS record for a domain. Use after confirming domain exists and record specifics. Risk: write
Input
Output: any

​
deleteDomainRecord

domainRecords.deleteDomainRecord Tool to delete a DNS record by its record ID for a domain. Use when you need to remove an existing DNS record and have the domain name and record ID. Returns HTTP 204 No Content on success. Risk: destructive · Irreversible
Input
Output: any

​
listDomainRecords

domainRecords.listDomainRecords Tool to list all DNS records for a domain. Use when you need to inspect or filter a domain’s DNS configuration. Risk: read
Input
Output: any

​
retrieveDomainRecord

domainRecords.retrieveDomainRecord Tool 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. Risk: read
Input
Output: any

​
updateDomainRecord

domainRecords.updateDomainRecord Tool 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. Risk: write
Input
Output: any

​
Domains

​
createNewDomain

domains.createNewDomain Creates 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. Risk: write
Input
Output: any

​
deleteDomain

domains.deleteDomain Deletes a domain from DigitalOcean DNS. This action is permanent and cannot be undone. Note: If the domain is associated with a Let’s Encrypt certificate, delete the certificate first and reconfigure any resources using it (e.g., load balancer SSL termination, Spaces CDN endpoints). Returns 204 No Content on successful deletion. Risk: destructive · Irreversible
Input
Output: any

​
listAllDomains

domains.listAllDomains Lists 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). Risk: read
Input
Output: any

​
retrieveDomain

domains.retrieveDomain Retrieves 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. Risk: read
Input
Output: any

​
Droplets

​
createNewDroplet

droplets.createNewDroplet Tool 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. Risk: write
Input
Output: any

​
deleteExistingDroplet

droplets.deleteExistingDroplet Tool 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. Risk: destructive · Irreversible
Input
Output: any

​
listAllDroplets

droplets.listAllDroplets Lists 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. Risk: read
Input
Output: any

​
retrieveExistingDroplet

droplets.retrieveExistingDroplet Retrieve 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. Risk: read
Input
Output: any

​
Firewalls

​
createNewFirewall

firewalls.createNewFirewall Creates 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. Risk: write
Input
Output: any

​
deleteFirewall

firewalls.deleteFirewall Tool to delete a firewall by ID. Use when you have confirmed the firewall is no longer needed. Risk: destructive · Irreversible
Input
Output: any

​
listAllFirewalls

firewalls.listAllFirewalls List 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. Risk: read
Input
Output: any

​
Images

​
createCustomImage

images.createCustomImage Creates 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. Risk: write
Input
Output: any

​
deleteImage

images.deleteImage Deletes 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. Risk: destructive · Irreversible
Input
Output: any

​
listAllImages

images.listAllImages Tool 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. Risk: read
Input
Output: any

​
retrieveExistingImage

images.retrieveExistingImage Tool to retrieve information about an image by ID or slug. Use when you need detailed metadata for a known image. Risk: read
Input
Output: any

​
Kubernetes

​
createNewKubernetesCluster

kubernetes.createNewKubernetesCluster Creates 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. Risk: write
Input
Output: any

​
listAllKubernetesClusters

kubernetes.listAllKubernetesClusters Tool to list all Kubernetes clusters on your account. Use when you need to enumerate every cluster and handle pagination. Risk: read
Input
Output: any

​
Load Balancers

​
createNewLoadBalancer

loadBalancers.createNewLoadBalancer Tool to create a new load balancer. Use after specifying region, forwarding rules, and targets. Risk: write
Input
Output: any

​
deleteLoadBalancer

loadBalancers.deleteLoadBalancer Tool to delete a load balancer instance by ID. Use when you need to permanently remove an existing load balancer after confirming its ID. Returns 204 No Content on success. Risk: destructive · Irreversible
Input
Output: any

​
listAllLoadBalancers

loadBalancers.listAllLoadBalancers List 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. Risk: read
Input
Output: any

​
Snapshots

​
listAllSnapshots

snapshots.listAllSnapshots Tool 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. Risk: read
Input
Output: any

​
Ssh Keys

​
createNewSshKey

sshKeys.createNewSshKey Registers 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. Risk: write
Input
Output: any

​
deleteSshKey

sshKeys.deleteSshKey Tool to delete a public SSH key. Use when you need to remove an SSH key from your account by its ID or fingerprint after confirming its ownership. Returns 204 No Content on success. Risk: destructive · Irreversible
Input
Output: any

​
listAllSshKeys

sshKeys.listAllSshKeys Lists 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. Risk: read
Input
Output: any

​
Tags

​
createNewTag

tags.createNewTag Creates 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. Risk: write
Input
Output: any

​
deleteTag

tags.deleteTag Deletes 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). Risk: destructive · Irreversible
Input
Output: any

​
listAllTags

tags.listAllTags Tool 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. Risk: read
Input
Output: any

​
retrieveTag

tags.retrieveTag Tool to retrieve an individual tag by name. Use when you need to inspect the resources grouped under a specific tag. Risk: read
Input
Output: any

​
tagResource

tags.tagResource Tool to tag resources by name. Use when you need to assign an existing tag to one or more resources. Returns 204 No Content on success. Risk: write
Input
Output: any

​
untagResource

tags.untagResource Tool to untag resources by tag name. Use when you need to remove an existing tag from multiple resources in a single operation. Risk: destructive
Input
Output: any

​
Volumes

​
createNewBlockStorageVolume

volumes.createNewBlockStorageVolume Tool 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.” Risk: write
Input
Output: any

​
deleteBlockStorageVolume

volumes.deleteBlockStorageVolume Permanently deletes a block storage volume by its unique ID. Use this tool when you need to remove an existing volume. The volume must not be attached to any Droplet before deletion. This operation cannot be undone. Returns HTTP 204 No Content on success. Note: To delete by volume name instead of ID, you would need a different endpoint that accepts both name and region parameters. Risk: destructive · Irreversible
Input
Output: any

​
listAllVolumes

volumes.listAllVolumes Tool to list all block storage volumes available on your account. Use when you need to retrieve volumes and optionally filter by name and region. Risk: read
Input
Output: any

​
Vpcs

​
createNewVpc

vpcs.createNewVpc Creates 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. Risk: write
Input
Output: any

​
deleteVpc

vpcs.deleteVpc Delete 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. Risk: destructive · Irreversible
Input
Output: any

​
listAllVpcs

vpcs.listAllVpcs Tool 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. Risk: read
Input
Output: any

​
retrieveVpc

vpcs.retrieveVpc Tool to retrieve details about a specific VPC by its ID. Use when you need to inspect VPC properties for configuration or auditing. Risk: read
Input
Output: any

​
updateVpc

vpcs.updateVpc Tool to update information about a VPC. Use when you need to modify the name, description, or default status of an existing VPC. Risk: write
Input
Output: any