# DigitalOcean Your Toolhouse AI Worker can connect to DigitalOcean using 48 specialized tools. ## Auth Connection This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=digital_ocean). ## Tools (48) ### `Digital Ocean Create Custom Image` Integration name: **DIGITAL\_OCEAN\_CREATE\_CUSTOM\_IMAGE** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `url` | string | ✅ | — | 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. | | `name` | string | ✅ | `"My-Linux-VM-Image"` | A human-readable name for the custom image (e.g., 'ubuntu-20.04-webserver'). | | `tags` | array | | `["web-server","archived"]` | Optional list of tag strings for organizing and categorizing the image. | | `region` | string | ✅ | `"nyc3"` | DigitalOcean region slug where the image will be initially stored (e.g., 'nyc1', 'nyc3', 'sfo2', 'sfo3', 'lon1', 'ams3'). | | `description` | string | | — | Optional detailed description of the image's purpose, contents, or configuration. | | `distribution` | string | ✅ | `"Ubuntu"` | Operating system distribution name. Valid options: 'Ubuntu', 'Debian', 'CentOS', 'Fedora', 'Arch Linux', or 'Unknown'. | *** ### `Digital Ocean Create Database Cluster` Integration name: **DIGITAL\_OCEAN\_CREATE\_DATABASE\_CLUSTER** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"my-db-cluster"` | Name for your database cluster | | `size` | string | ✅ | `"db-s-1vcpu-1gb"` | Size slug for the database nodes. Examples: db-s-1vcpu-1gb, db-s-2vcpu-4gb, gd-2vcpu-8gb | | `tags` | array | | `"prod"` | Tags to assign to the cluster | | `engine` | string | ✅ | `"pg"` | Database engine type: 'pg' (PostgreSQL), 'mysql' (MySQL), 'valkey' (Redis-compatible), 'mongodb' (MongoDB), 'kafka' (Apache Kafka), 'opensearch' (OpenSearch) | | `region` | string | ✅ | `"nyc1"` | Region slug where the cluster will be created. Examples: nyc1, nyc3, sfo3, lon1, fra1, ams3, sgp1, tor1, blr1 | | `version` | string | ✅ | `"16"` | Database engine version. Examples: '16' for PostgreSQL, '8' for MySQL/Valkey, '8.0' for MongoDB, '3.8' for Kafka, '2' for OpenSearch | | `db_names` | array | | `"appdb"` | Names of databases to create in the cluster | | `sql_mode` | string | | `"STRICT_TRANS_TABLES"` | SQL mode for MySQL clusters | | `num_nodes` | integer | ✅ | `1` | Number of nodes in the cluster. Typical values: 1 (single node), 2 (primary + standby), 3 (high availability) | | `user_names` | array | | `"appuser"` | Usernames to create in the cluster | | `backup_restore` | object | | — | Configuration to restore a cluster from a backup | | `eviction_policy` | string | | `"volatile-lru"` | Eviction policy for Redis clusters | | `storage_size_gb` | integer | | `10` | Additional storage size in GiB for the cluster | | `maintenance_window` | object | | — | Maintenance window configuration for the cluster | | `private_network_uuid` | string | | `"e9c9f0b0-3b93-4f76-8a77-1f0e5d6b1234"` | UUID of VPC network for private networking | *** ### `Digital Ocean Create New Block Storage Volume` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_BLOCK\_STORAGE\_VOLUME** 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." #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------- | | `name` | string | ✅ | `"db-backup-volume"` | A human-readable name for the block storage volume. | | `tags` | array | | `["production","database"]` | List of tags to apply to the volume. | | `region` | string | ✅ | `"nyc1"` | Slug identifier for the region where the volume will be created (e.g., 'nyc1'). | | `description` | string | | `"Nightly database backups"` | Free-form text description of the volume. | | `snapshot_id` | string | | `"f3a1b2c3-d4e5-6789-abcd-ef0123456789"` | Unique identifier of a snapshot to create the volume from. | | `size_gigabytes` | integer | ✅ | `100` | Size of the block storage volume in GiB (minimum 1). | | `filesystem_type` | string | | `"ext4"` | Filesystem type to initialize on the volume (e.g., 'ext4'). | | `filesystem_label` | string | | `"backup_vol"` | Label to apply to the filesystem. | *** ### `Digital Ocean Create New Domain` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_DOMAIN** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `name` | string | ✅ | `"example.com"` | 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. | | `ip_address` | string | | `"192.0.2.1"` | 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. | *** ### `Digital Ocean Create New Domain Record` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_DOMAIN\_RECORD** Tool to create a new DNS record for a domain. Use after confirming domain exists and record specifics. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `tag` | string | | `"issue"` | Tag for CAA records (issue, issuewild, iodef); required if type is CAA | | `ttl` | integer | | `1800` | Time to live for the record in seconds | | `data` | string | ✅ | `"1.2.3.4"` | 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.') | | `name` | string | | `"www"` | Host name for the record (e.g., 'www'). Use '@' for root domain | | `port` | integer | | `5060` | Port for SRV records; required if type is SRV | | `type` | string | ✅ | `"A"` | Type of DNS record to create | | `flags` | integer | | `0` | Flags for CAA records; required if type is CAA | | `weight` | integer | | `5` | Weight for SRV records; required if type is SRV | | `priority` | integer | | `10` | Priority for MX and SRV records; required if type is MX or SRV | | `domain_name` | string | ✅ | `"example.com"` | The domain name to add the record to, e.g., 'example.com' | *** ### `Digital Ocean Create New Droplet` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_DROPLET** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------ | | `ipv6` | boolean | | `true` | Whether IPv6 is enabled | | `name` | string | ✅ | `"example-vm"` | A human-readable name for the Droplet | | `size` | string | ✅ | `"s-1vcpu-1gb"` | Size slug for the Droplet | | `tags` | array | | `"web"` | List of tags to apply to the Droplet | | `image` | — | ✅ | `"ubuntu-20-04-x64"` | Image slug or ID to use for the Droplet | | `region` | string | ✅ | `"nyc3"` | Region slug where the Droplet will be created | | `backups` | boolean | | `true` | Whether automatic backups are enabled | | `volumes` | array | | `"volume-id-1"` | IDs of volumes to attach to the Droplet | | `ssh_keys` | array | | `123456` | List of SSH key IDs or fingerprints to embed | | `vpc_uuid` | string | | `"123e4567-e89b-12d3-a456-426614174000"` | VPC UUID to assign the Droplet to | | `user_data` | string | | `"#cloud-config..."` | User data (cloud-init) script to configure the Droplet | | `monitoring` | boolean | | `true` | Whether monitoring is enabled | | `private_networking` | boolean | | — | Deprecated: use 'vpc\_uuid' instead | | `with_droplet_agent` | boolean | | `true` | Whether to install the Droplet agent for metrics | *** ### `Digital Ocean Create New Firewall` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_FIREWALL** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------- | | `name` | string | ✅ | `"web-firewall"` | Name of the new firewall. | | `tags` | array | | — | Optional list of Droplet tags to apply the firewall to matching droplets. | | `vpc_uuid` | string | | — | Optional VPC UUID to scope this firewall to a VPC. | | `droplet_ids` | array | | — | Optional list of Droplet IDs to apply the firewall to. | | `inbound_rules` | array | ✅ | — | List of inbound rules; must contain at least one. | | `outbound_rules` | array | ✅ | — | List of outbound rules; must contain at least one. | *** ### `Digital Ocean Create New Kubernetes Cluster` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_KUBERNETES\_CLUSTER** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------- | ------- | :------: | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"example-cluster"` | A human-readable name for the Kubernetes cluster. | | `tags` | array | | `"frontend"` | List of tags to apply to the cluster. | | `region` | string | ✅ | `"nyc1"` | Region slug where the cluster will be created. Common regions: nyc1, nyc3, sfo3, lon1, fra1, tor1, blr1, sgp1, ams3, syd1. | | `version` | string | ✅ | `"1.34.1-do.3"` | 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. | | `node_pools` | array | ✅ | `{"name":"frontend-pool","size":"s-1vcpu-2gb","count":3}` | List of node pools; at least one required. | | `auto_upgrade` | boolean | | `true` | Whether to auto-upgrade to new patch releases. | | `maintenance_policy` | object | | — | Scheduled maintenance policy for the cluster. | *** ### `Digital Ocean Create New Load Balancer` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_LOAD\_BALANCER** Tool to create a new load balancer. Use after specifying region, forwarding rules, and targets. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------------------- | ------- | :------: | ---------------------------------------- | --------------------------------------------------------------------- | | `tag` | string | | `"web"` | Tag to select droplets (mutually exclusive with droplet\_ids). | | `name` | string | ✅ | `"lb-web"` | Unique name for the new load balancer. | | `region` | string | ✅ | `"nyc1"` | Region slug where the load balancer will be created (e.g., 'nyc1'). | | `vpc_uuid` | string | | `"123e4567-e89b-12d3-a456-426614174000"` | UUID of the VPC to assign the load balancer to. | | `algorithm` | string | | `"round_robin"` | Load balancing algorithm to use; defaults to 'round\_robin'. | | `droplet_ids` | array | | `123` | List of droplet IDs to attach (mutually exclusive with tag). | | `health_check` | object | | — | Optional health check configuration. | | `firewall_policy` | string | | — | ID of a custom firewall policy to apply. | | `sticky_sessions` | object | | — | Optional session persistence configuration. | | `forwarding_rules` | array | ✅ | — | List of forwarding rules mapping entry to target protocols and ports. | | `enable_proxy_protocol` | boolean | | — | Enable PROXY protocol for backend connections. | | `redirect_http_to_https` | boolean | | — | Redirect HTTP traffic to HTTPS. | | `enable_backend_keepalive` | boolean | | — | Enable keepalive connections to backend droplets. | *** ### `Digital Ocean Create New Ssh Key` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_SSH\_KEY** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"my-server-key"` | 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. | | `public_key` | string | ✅ | `"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQC... user@host"` | 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. | *** ### `Digital Ocean Create New Tag` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_TAG** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ------------- | ----------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"analytics"` | The name of the new tag. Must be 1-255 characters and only contain alphanumeric characters, hyphens (-), or underscores (\_). | *** ### `Digital Ocean Create New Vpc` Integration name: **DIGITAL\_OCEAN\_CREATE\_NEW\_VPC** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"backend-vpc"` | The name of the VPC. Must be unique within your account. | | `tags` | array | | `["frontend","production"]` | List of tag names to apply to the VPC after creation. | | `region` | string | ✅ | `"nyc3"` | 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). | | `ip_range` | string | | `"10.20.0.0/16"` | 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. | | `description` | string | | `"Backend services network"` | A free-form description of the VPC. | *** ### `Digital Ocean Delete Block Storage Volume` Integration name: **DIGITAL\_OCEAN\_DELETE\_BLOCK\_STORAGE\_VOLUME** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | `volume_id` | string | ✅ | `"4ba0f0fd-e4d5-4d62-82f0-2b4d6e40d760"` | The unique identifier (UUID) of the block storage volume to delete. The volume must not be attached to any Droplet. | *** ### `Digital Ocean Delete Database Cluster` Integration name: **DIGITAL\_OCEAN\_DELETE\_DATABASE\_CLUSTER** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------------- | ------ | :------: | ---------------------------------------- | ------------------------------------------- | | `database_cluster_uuid` | string | ✅ | `"6cfbcb0f-939a-40d9-a0c6-f5a885f3eb31"` | The UUID of the database cluster to destroy | *** ### `Digital Ocean Delete Domain` Integration name: **DIGITAL\_OCEAN\_DELETE\_DOMAIN** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | --------------- | -------------------------------------------------------------- | | `name` | string | ✅ | `"example.com"` | The fully qualified domain name to delete, e.g., 'example.com' | *** ### `Digital Ocean Delete Domain Record` Integration name: **DIGITAL\_OCEAN\_DELETE\_DOMAIN\_RECORD** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | --------------- | -------------------------------------------------- | | `name` | string | ✅ | `"example.com"` | The domain name (e.g., 'example.com'). | | `record_id` | integer | ✅ | `123456` | The unique identifier of the DNS record to delete. | *** ### `Digital Ocean Delete Existing Droplet` Integration name: **DIGITAL\_OCEAN\_DELETE\_EXISTING\_DROPLET** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | -------- | ------------------------------------------ | | `droplet_id` | integer | ✅ | `123456` | Unique identifier of the Droplet to delete | *** ### `Digital Ocean Delete Firewall` Integration name: **DIGITAL\_OCEAN\_DELETE\_FIREWALL** Tool to delete a firewall by ID. Use when you have confirmed the firewall is no longer needed. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ---------------------------------------- | ------------------------------------------- | | `firewall_id` | string | ✅ | `"a1b2c3d4-e5f6-7890-abcd-1234567890ab"` | Unique identifier of the firewall to delete | *** ### `Digital Ocean Delete Image` Integration name: **DIGITAL\_OCEAN\_DELETE\_IMAGE** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `image_id` | integer | ✅ | `123456789` | 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. | *** ### `Digital Ocean Delete Load Balancer` Integration name: **DIGITAL\_OCEAN\_DELETE\_LOAD\_BALANCER** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------------ | ------ | :------: | ---------------------------------------- | ------------------------------------------------- | | `load_balancer_id` | string | ✅ | `"123e4567-e89b-12d3-a456-426614174000"` | Unique identifier of the load balancer to delete. | *** ### `Digital Ocean Delete Ssh Key` Integration name: **DIGITAL\_OCEAN\_DELETE\_SSH\_KEY** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------------- | ------ | :------: | ------------ | ----------------------------------------------------------- | | `key_id_or_fingerprint` | string | ✅ | `"12345678"` | The identifier for the SSH key (numeric ID or fingerprint). | *** ### `Digital Ocean Delete Tag` Integration name: **DIGITAL\_OCEAN\_DELETE\_TAG** 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). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | --------------- | ---------------------------------------------------------------------------- | | `name` | string | ✅ | `"example-tag"` | The name of the tag to delete; all resources with this tag will be untagged. | *** ### `Digital Ocean Delete Vpc` Integration name: **DIGITAL\_OCEAN\_DELETE\_VPC** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | ---------------------------------------- | -------------------------------------- | | `vpc_id` | string | ✅ | `"e0a1b23c-9d8f-4e7b-a1b2-3c4d5e6f7g8h"` | Unique identifier of the VPC to delete | *** ### `Digital Ocean List All Databases` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_DATABASES** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | -------------- | -------------------------------------------------------------- | | `page` | integer | | `1` | Page number to retrieve (starting from 1). | | `per_page` | integer | | `20` | Number of items to return per page. Must be between 1 and 200. | | `tag_name` | string | | `"production"` | Filter to return only database clusters with this tag name. | *** ### `Digital Ocean List All Domains` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_DOMAINS** 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). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | ----------------------------------------------------------------------- | | `page` | integer | | `1` | Page number to retrieve (starting from 1). | | `per_page` | integer | | `20` | Number of domains to return per page (1-200). Default is 20 if omitted. | *** ### `Digital Ocean List All Droplets` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_DROPLETS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | -------------- | ------------------------------------------------------------------- | | `page` | integer | | `1` | Page of results to return. Must be >= 1. Default is 1. | | `per_page` | integer | | `20` | Number of items per page. Must be between 1 and 200. Default is 20. | | `tag_name` | string | | `"production"` | Filter droplets by tag name. | *** ### `Digital Ocean List All Firewalls` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_FIREWALLS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | ----------------------------------------------- | | `page` | integer | | `1` | Page number to retrieve (starting from 1). | | `per_page` | integer | | `20` | Number of firewalls to return per page (1-200). | *** ### `Digital Ocean List All Images` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_IMAGES** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ---------------- | ------------------------------------------------------------------------------ | | `page` | integer | | `1` | Page number to return. Default: 1. Minimum: 1. | | `type` | string | | `"distribution"` | Filter images by type. Valid values: 'distribution', 'application', 'private'. | | `private` | boolean | | `true` | If true, returns only private images. Defaults to false. | | `per_page` | integer | | `20` | Number of results per page. Default: 20. Range: 1-200. | | `tag_name` | string | | `"web"` | Return only images tagged with this tag. | *** ### `Digital Ocean List All Kubernetes Clusters` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_KUBERNETES\_CLUSTERS** Tool to list all Kubernetes clusters on your account. Use when you need to enumerate every cluster and handle pagination. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | ------------------------------------------------------- | | `page` | integer | | `1` | Page number of paginated results (starting from 1). | | `per_page` | integer | | `20` | Number of clusters per page. Must be between 1 and 200. | *** ### `Digital Ocean List All Load Balancers` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_LOAD\_BALANCERS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | ------------------------------------------------------------------- | | `page` | integer | | `1` | Page of results to return. Must be >= 1. Default is 1. | | `per_page` | integer | | `20` | Number of items per page. Must be between 1 and 200. Default is 20. | *** ### `Digital Ocean List All Snapshots` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_SNAPSHOTS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | ----------- | ---------------------------------------------------------------- | | `page` | integer | | `1` | Page number to retrieve (starting from 1). | | `per_page` | integer | | `20` | Number of snapshots to return per page (1-200). | | `resource_type` | string | | `"droplet"` | Filter snapshots by resource type; either 'droplet' or 'volume'. | *** ### `Digital Ocean List All Ssh Keys` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_SSH\_KEYS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | `page` | integer | | `1` | Page number to retrieve (starting from 1). Use with per\_page to navigate through paginated results. Omit to get the first page. | | `per_page` | integer | | `20` | 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. | *** ### `Digital Ocean List All Tags` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_TAGS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | ------------------------------------------------------------- | | `page` | integer | | `1` | Page number to retrieve (starting from 1). | | `per_page` | integer | | `20` | Number of items returned per page. Must be between 1 and 200. | *** ### `Digital Ocean List All Volumes` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_VOLUMES** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------------------ | ------------------------------------------------------------- | | `name` | string | | `"example-volume"` | Filter to return only volumes with this exact name. | | `page` | integer | | `1` | Page number to retrieve (starting from 1). | | `region` | string | | `"nyc1"` | Filter to return only volumes in this region (region slug). | | `per_page` | integer | | `20` | Number of items returned per page. Must be between 1 and 200. | *** ### `Digital Ocean List All Vpcs` Integration name: **DIGITAL\_OCEAN\_LIST\_ALL\_VPCS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------- | ---------------------------------------------------------- | | `page` | integer | | `1` | Page number to retrieve (default: 1). | | `per_page` | integer | | `20` | Number of VPCs to return per page (default: 20, max: 200). | *** ### `Digital Ocean List Apps` Integration name: **DIGITAL\_OCEAN\_LIST\_APPS** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | ------- | -------------------------------------------------------------------------------------- | | `page` | integer | | `1` | Which 'page' of paginated results to return. Must be >= 1. Default is 1. | | `per_page` | integer | | `20` | Number of items returned per page. Must be between 1 and 200. Default is 20. | | `with_projects` | boolean | | `true` | Whether the project\_id of listed apps should be fetched and included in the response. | *** ### `Digital Ocean List Database Options` Integration name: **DIGITAL\_OCEAN\_LIST\_DATABASE\_OPTIONS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Digital Ocean List Domain Records` Integration name: **DIGITAL\_OCEAN\_LIST\_DOMAIN\_RECORDS** Tool to list all DNS records for a domain. Use when you need to inspect or filter a domain's DNS configuration. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | --------------- | --------------------------------------------------------------------- | | `page` | integer | | `1` | Page of results to return (>= 1). | | `type` | string | | `"A"` | Filter records by DNS record type. | | `per_page` | integer | | `20` | Number of results per page (1-200). | | `domain_name` | string | ✅ | `"example.com"` | The domain name whose records are to be listed (e.g., 'example.com'). | | `record_name` | string | | `"www"` | Filter records by record name (e.g., 'www', '@' for root domain). | *** ### `Digital Ocean Retrieve Domain` Integration name: **DIGITAL\_OCEAN\_RETRIEVE\_DOMAIN** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | --------------- | ------------------------------------------------------ | | `name` | string | ✅ | `"example.com"` | The fully qualified domain name (e.g., 'example.com'). | *** ### `Digital Ocean Retrieve Domain Record` Integration name: **DIGITAL\_OCEAN\_RETRIEVE\_DOMAIN\_RECORD** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | --------------- | ----------------------------------------- | | `name` | string | ✅ | `"example.com"` | The domain name (e.g., 'example.com'). | | `record_id` | integer | ✅ | `123456` | The unique identifier for the DNS record. | *** ### `Digital Ocean Retrieve Existing Droplet` Integration name: **DIGITAL\_OCEAN\_RETRIEVE\_EXISTING\_DROPLET** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `droplet_id` | integer | ✅ | `123456` | The unique numeric identifier of the Droplet you want to retrieve information about. You can obtain droplet IDs from the List All Droplets action. | *** ### `Digital Ocean Retrieve Existing Image` Integration name: **DIGITAL\_OCEAN\_RETRIEVE\_EXISTING\_IMAGE** Tool to retrieve information about an image by ID or slug. Use when you need detailed metadata for a known image. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ---- | :------: | --------- | ------------------------------------------------------- | | `image_id` | — | ✅ | `1234567` | The unique numeric ID or slug of the image to retrieve. | *** ### `Digital Ocean Retrieve Tag` Integration name: **DIGITAL\_OCEAN\_RETRIEVE\_TAG** Tool to retrieve an individual tag by name. Use when you need to inspect the resources grouped under a specific tag. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------- | ------ | :------: | -------------- | ------------------------------------------------- | | `name` | string | ✅ | `"production"` | The name of the tag to retrieve (case-sensitive). | *** ### `Digital Ocean Retrieve Vpc` Integration name: **DIGITAL\_OCEAN\_RETRIEVE\_VPC** Tool to retrieve details about a specific VPC by its ID. Use when you need to inspect VPC properties for configuration or auditing. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------------------------------- | --------------------------------- | | `vpc_uuid` | string | ✅ | `"e6b3f4f4-4a86-4bde-b608-123456789abc"` | The unique identifier of the VPC. | *** ### `Digital Ocean Tag Resource` Integration name: **DIGITAL\_OCEAN\_TAG\_RESOURCE** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ------------ | -------------------------------------------------------------- | | `tag_name` | string | ✅ | `"env:prod"` | The name of the tag to which resources will be assigned | | `resources` | array | ✅ | — | List of resources to assign the tag to (each with id and type) | *** ### `Digital Ocean Untag Resource` Integration name: **DIGITAL\_OCEAN\_UNTAG\_RESOURCE** Tool to untag resources by tag name. Use when you need to remove an existing tag from multiple resources in a single operation. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | -------------- | --------------------------------------------------------------------------- | | `tag_name` | string | ✅ | `"production"` | Name of the tag to remove from the specified resources. | | `resources` | array | ✅ | — | List of resource objects to untag, each with id, type, and optional region. | *** ### `Digital Ocean Update Domain Record` Integration name: **DIGITAL\_OCEAN\_UPDATE\_DOMAIN\_RECORD** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | --------------- | -------------------------------------------------------------------- | | `tag` | string | | — | Tag for CAA records. | | `ttl` | integer | | — | Time to live of the record in seconds. | | `data` | string | | — | The value of the DNS record (e.g., IP address for A/AAAA record). | | `name` | string | | — | The host name for the record (e.g., 'www', '@'). | | `port` | integer | | — | Port for SRV records. | | `type` | string | | — | The DNS record type (e.g., 'A', 'CNAME', 'TXT', 'MX', 'SRV', 'CAA'). | | `flags` | integer | | — | Flags for CAA records. | | `weight` | integer | | — | Weight for SRV records. | | `priority` | integer | | — | Priority for MX records. | | `record_id` | integer | ✅ | `123456` | The unique identifier for the DNS record. | | `domain_name` | string | ✅ | `"example.com"` | The domain name (e.g., 'example.com'). | *** ### `Digital Ocean Update Vpc` Integration name: **DIGITAL\_OCEAN\_UPDATE\_VPC** Tool to update information about a VPC. Use when you need to modify the name, description, or default status of an existing VPC. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------ | | `name` | string | | `"my-vpc"` | The new name for the VPC. | | `vpc_id` | string | ✅ | `"a1b2c3d4-5e6f-7g8h-9i0j-1234567890ab"` | The unique identifier of the VPC to update. | | `default` | boolean | | `true` | Whether to set this VPC as the default for its region. | | `description` | string | | `"My VPC for web applications"` | A free-form text description for the VPC. | *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/digitalocean.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.