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.
View Overlay File View on GitHub Overlay Specification

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

Raw ↑
# 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.
All 92 tools →

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.