Digital Ocean · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for DigitalOcean Kubernetes API
29 actions
29 updates
phrasing
extends
openapi/digital-ocean-kubernetes-api-openapi.yml
Generated by API Evangelist
Written by API Evangelist tooling for Digital Ocean's API. It is a proposal applied on top of the contract, not a document Digital Ocean publishes.
What the actions change
x-apievangelist-phrasing
Targets 29 · first 16 shown; the file carries all of them
$.info
$.paths['/v2/kubernetes/clusters'].get
$.paths['/v2/kubernetes/clusters'].post
$.paths['/v2/kubernetes/clusters/{cluster_id}'].get
$.paths['/v2/kubernetes/clusters/{cluster_id}'].put
$.paths['/v2/kubernetes/clusters/{cluster_id}'].delete
$.paths['/v2/kubernetes/clusters/{cluster_id}/destroy_with_associated_resources'].get
$.paths['/v2/kubernetes/clusters/{cluster_id}/destroy_with_associated_resources/selective'].delete
$.paths['/v2/kubernetes/clusters/{cluster_id}/destroy_with_associated_resources/dangerous'].delete
$.paths['/v2/kubernetes/clusters/{cluster_id}/kubeconfig'].get
$.paths['/v2/kubernetes/clusters/{cluster_id}/credentials'].get
$.paths['/v2/kubernetes/clusters/{cluster_id}/upgrades'].get
$.paths['/v2/kubernetes/clusters/{cluster_id}/upgrade'].post
$.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools'].get
$.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools'].post
$.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools/{node_pool_id}'].get
OpenAPI Overlay
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for DigitalOcean Kubernetes API
version: 1.0.0
extends: openapi/digital-ocean-kubernetes-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-11-18'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 28
- target: $.paths['/v2/kubernetes/clusters'].get
update:
x-apievangelist-phrasing:
intent: List Kubernetes clusters
effect: read
questions:
- Which managed Kubernetes clusters do I have?
- Can I see all my DO Kubernetes clusters at once?
instructions:
- text: List all my Kubernetes clusters.
- text: Show every managed cluster in my account.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters'].post
update:
x-apievangelist-phrasing:
intent: Create a Kubernetes cluster
effect: write
questions:
- How do I spin up a new managed Kubernetes cluster?
- Can I create a cluster with a specific version and region?
instructions:
- text: Create a new Kubernetes cluster.
- text: Spin up a managed cluster with my chosen settings.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}'].get
update:
x-apievangelist-phrasing:
intent: Get a Kubernetes cluster
effect: read
questions:
- What version and status is one of my clusters in?
- Can I look up a single managed cluster by its ID?
instructions:
- text: Show Kubernetes cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Get the status and version of cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}'].put
update:
x-apievangelist-phrasing:
intent: Replace a Kubernetes cluster
effect: write
questions:
- Can I replace a whole cluster's configuration at once?
- Is there a full cluster replacement call?
instructions:
- text: Replace the entire configuration of Kubernetes cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Overwrite cluster {cluster_id} with a new cluster definition.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a Kubernetes cluster
effect: destructive
questions:
- How do I delete a managed Kubernetes cluster?
- Can I remove a cluster I no longer need?
instructions:
- text: Delete Kubernetes cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Remove the managed cluster {cluster_id} from my account.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/destroy_with_associated_resources'].get
update:
x-apievangelist-phrasing:
intent: Get the destroy-with-resources status
effect: read
questions:
- Will deleting my cluster also remove its load balancers and volumes?
- What does the destroy-with-associated-resources flag mean?
instructions:
- text: Check whether cluster {cluster_id} destroys associated resources.
slots:
cluster_id: path.cluster_id
- text: Show the destroy-with-resources status for cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/destroy_with_associated_resources/selective'].delete
update:
x-apievangelist-phrasing:
intent: Delete a cluster with selective resource removal
effect: destructive
questions:
- Can I delete a cluster and keep some of its resources?
- Is there a selective delete-with-resources option?
instructions:
- text: Delete cluster {cluster_id} with selective resource removal.
slots:
cluster_id: path.cluster_id
- text: Remove cluster {cluster_id} but keep its load balancers.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/destroy_with_associated_resources/dangerous'].delete
update:
x-apievangelist-phrasing:
intent: Delete a cluster with all resources
effect: destructive
questions:
- How do I delete a cluster and everything attached to it?
- Can I blow away a cluster and all its resources in one call?
instructions:
- text: Delete cluster {cluster_id} with all associated resources.
slots:
cluster_id: path.cluster_id
- text: Blow away cluster {cluster_id} and every resource it owns.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/kubeconfig'].get
update:
x-apievangelist-phrasing:
intent: Get a cluster's kubeconfig
effect: read
questions:
- Where do I get the kubeconfig file to connect to my cluster?
- Can I download the cluster's kubeconfig for kubectl?
instructions:
- text: Get the kubeconfig for Kubernetes cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Download the cluster {cluster_id} config for kubectl.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/credentials'].get
update:
x-apievangelist-phrasing:
intent: Get a cluster's admin credentials
effect: read
questions:
- What admin credentials does my cluster use?
- Can I fetch the cluster's admin user and password?
instructions:
- text: Get the admin credentials for cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Show the admin user and password for cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/upgrades'].get
update:
x-apievangelist-phrasing:
intent: List a cluster's upgrade options
effect: read
questions:
- What Kubernetes versions can I upgrade my cluster to?
- Which upgrades are available for a cluster?
instructions:
- text: List upgrade options for cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Show which versions cluster {cluster_id} can be upgraded to.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/upgrade'].post
update:
x-apievangelist-phrasing:
intent: Upgrade a cluster's version
effect: write
questions:
- How do I upgrade my cluster to a newer Kubernetes version?
- Can I change a cluster's Kubernetes version in place?
instructions:
- text: Upgrade cluster {cluster_id} to a new Kubernetes version.
slots:
cluster_id: path.cluster_id
- text: Change the Kubernetes version of cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools'].get
update:
x-apievangelist-phrasing:
intent: List a cluster's node pools
effect: read
questions:
- Which node pools does my cluster have?
- Can I see the node pool sizes and counts for a cluster?
instructions:
- text: List the node pools of cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Show how many nodes and what sizes each pool in cluster {cluster_id} has.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools'].post
update:
x-apievangelist-phrasing:
intent: Add a node pool to a cluster
effect: write
questions:
- How do I add a new node pool to an existing cluster?
- Can I grow a cluster by adding another node pool?
instructions:
- text: Add a new node pool to cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Grow cluster {cluster_id} with an additional node pool.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools/{node_pool_id}'].get
update:
x-apievangelist-phrasing:
intent: Get a cluster's node pool
effect: read
questions:
- What size and count does a particular node pool have?
- Can I look up one node pool of a cluster by its ID?
instructions:
- text: Show node pool {node_pool_id} of cluster {cluster_id}.
slots:
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
- text: Get the size and count of pool {node_pool_id} in cluster {cluster_id}.
slots:
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools/{node_pool_id}'].put
update:
x-apievangelist-phrasing:
intent: Replace a cluster's node pool
effect: write
questions:
- Can I replace a node pool's configuration entirely?
- Is there a full node pool replacement call?
instructions:
- text: Replace node pool {node_pool_id} of cluster {cluster_id}.
slots:
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
- text: Overwrite the configuration of pool {node_pool_id} in cluster {cluster_id}.
slots:
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools/{node_pool_id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a cluster's node pool
effect: destructive
questions:
- How do I remove a node pool from a cluster?
- Can I delete a node pool without deleting the cluster?
instructions:
- text: Delete node pool {node_pool_id} from cluster {cluster_id}.
slots:
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
- text: Remove pool {node_pool_id} from cluster {cluster_id} but keep the cluster.
slots:
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools/{node_pool_id}/nodes/{node_id}'].delete
update:
x-apievangelist-phrasing:
intent: Recycle a single node
effect: destructive
questions:
- How do I reboot just one node in a pool?
- Can I recycle a single node without touching the pool?
instructions:
- text: Recycle node {node_id} in pool {node_pool_id} of cluster {cluster_id}.
slots:
node_id: path.node_id
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
- text: Reboot just node {node_id} in pool {node_pool_id} on cluster {cluster_id}.
slots:
node_id: path.node_id
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/node_pools/{node_pool_id}/recycle'].post
update:
x-apievangelist-phrasing:
intent: Recycle a node pool
effect: destructive
questions:
- How do I reboot every node in a node pool?
- Can I recycle a whole node pool at once?
instructions:
- text: Recycle all nodes in pool {node_pool_id} of cluster {cluster_id}.
slots:
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
- text: Reboot every node in pool {node_pool_id} on cluster {cluster_id}.
slots:
node_pool_id: path.node_pool_id
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/user'].get
update:
x-apievangelist-phrasing:
intent: Get a cluster's user
effect: read
questions:
- Which user account is a cluster using?
- Can I see the user details for a cluster?
instructions:
- text: Show the user for cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Get the user account details of cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/options'].get
update:
x-apievangelist-phrasing:
intent: List Kubernetes cluster options
effect: read
questions:
- Which Kubernetes versions and sizes can I choose when creating a cluster?
- What options are available for new Kubernetes clusters?
instructions:
- text: Show the Kubernetes options available for new clusters.
- text: List the Kubernetes versions and sizes I can use.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/clusterlint'].get
update:
x-apievangelist-phrasing:
intent: Run a cluster lint check
effect: read
questions:
- Can I check a Kubernetes cluster for common configuration errors?
- What does a cluster lint report find?
instructions:
- text: Run a cluster lint check on cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Check cluster {cluster_id} for common Kubernetes configuration issues.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/clusterlint'].post
update:
x-apievangelist-phrasing:
intent: Submit a cluster lint check
effect: write
questions:
- How do I submit a cluster lint report?
- Can I send a cluster lint check for a cluster I already have?
instructions:
- text: Submit a cluster lint check for cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Send a cluster lint report for cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/registry'].post
update:
x-apievangelist-phrasing:
intent: Create a Kubernetes registry
effect: write
questions:
- How do I create a private registry for my Kubernetes clusters?
- Can I add a registry for storing container images?
instructions:
- text: Create a Kubernetes registry.
- text: Add a private registry for my clusters.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/registry'].delete
update:
x-apievangelist-phrasing:
intent: Delete a Kubernetes registry
effect: destructive
questions:
- How do I remove a Kubernetes registry?
- Can I delete a registry I no longer use?
instructions:
- text: Delete the Kubernetes registry.
- text: Remove the private registry from my account.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/registries'].post
update:
x-apievangelist-phrasing:
intent: Create multiple Kubernetes registries
effect: write
questions:
- Can I create several Kubernetes registries at once?
- How do I add multiple private registries?
instructions:
- text: Create several Kubernetes registries.
- text: Add multiple private registries to my account.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/registries'].delete
update:
x-apievangelist-phrasing:
intent: Delete multiple Kubernetes registries
effect: destructive
questions:
- How do I remove several Kubernetes registries at once?
- Can I delete multiple private registries together?
instructions:
- text: Delete several Kubernetes registries.
- text: Remove multiple private registries from my account.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/kubernetes/clusters/{cluster_id}/status_messages'].get
update:
x-apievangelist-phrasing:
intent: Get a cluster's status messages
effect: read
questions:
- What status messages has my Kubernetes cluster posted?
- Can I read the status messages for a cluster?
instructions:
- text: Show the status messages for cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
- text: Read the status messages of cluster {cluster_id}.
slots:
cluster_id: path.cluster_id
method: generated
generated: '2026-11-18'
Work with this as data
Every overlay here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for openapi overlays
4 MCP tools reach this
find_overlaysBrowse and filter every overlay in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/digital-ocean-kubernetes-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.