Digital Ocean · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for DigitalOcean Droplets API

31 actions 31 updates phrasing extends openapi/digital-ocean-droplets-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 31 · first 16 shown; the file carries all of them

$.info
$.paths['/v2/droplets'].get
$.paths['/v2/droplets'].post
$.paths['/v2/droplets'].delete
$.paths['/v2/droplets/{droplet_id}'].get
$.paths['/v2/droplets/{droplet_id}'].delete
$.paths['/v2/droplets/{droplet_id}/backups'].get
$.paths['/v2/droplets/{droplet_id}/backups/policy'].get
$.paths['/v2/droplets/backups/policies'].get
$.paths['/v2/droplets/backups/supported_policies'].get
$.paths['/v2/droplets/{droplet_id}/snapshots'].get
$.paths['/v2/droplets/{droplet_id}/actions'].get
$.paths['/v2/droplets/{droplet_id}/actions'].post
$.paths['/v2/droplets/actions'].post
$.paths['/v2/droplets/{droplet_id}/actions/{action_id}'].get
$.paths['/v2/droplets/{droplet_id}/kernels'].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 Droplets API
  version: 1.0.0
extends: openapi/digital-ocean-droplets-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: 30
- target: $.paths['/v2/droplets'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Droplets
      effect: read
      questions:
      - Which Droplets do I have running?
      - Can I see all my virtual machines at once?
      instructions:
      - text: List all my Droplets.
      - text: Show every virtual machine I own.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Droplet
      effect: write
      questions:
      - How do I spin up a new virtual machine?
      - Can I create a Droplet from a snapshot?
      instructions:
      - text: Create a new Droplet.
      - text: Spin up a virtual machine for me.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete Droplets in bulk
      effect: destructive
      questions:
      - Can I delete several Droplets at once?
      - Is there a bulk delete for Droplets?
      instructions:
      - text: Delete all my Droplets in one request.
      - text: Bulk remove every virtual machine I own.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Droplet
      effect: read
      questions:
      - What are the details of one Droplet?
      - Can I look up a single virtual machine by ID?
      instructions:
      - text: Show Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Get the details of virtual machine {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Droplet
      effect: destructive
      questions:
      - How do I delete one Droplet?
      - Can I remove a single virtual machine by ID?
      instructions:
      - text: Delete Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Remove virtual machine {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/backups'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Droplet's backups
      effect: read
      questions:
      - What backups exist for my Droplet?
      - Can I see the backup history of one virtual machine?
      instructions:
      - text: List backups for Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Show the backup history of virtual machine {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/backups/policy'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Droplet's backup policy
      effect: read
      questions:
      - Is automatic backup enabled on my Droplet?
      - What backup policy does one virtual machine follow?
      instructions:
      - text: Get the backup policy of Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Show whether automatic backup is on for virtual machine {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/backups/policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List backup policies for Droplets
      effect: read
      questions:
      - What backup policies can I choose for Droplets?
      - Which backup policy options exist for virtual machines?
      instructions:
      - text: List Droplet backup policies.
      - text: Show every backup policy available to virtual machines.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/backups/supported_policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported Droplet backup policies
      effect: read
      questions:
      - Which backup policies does the Droplet backup service support?
      - What backup policy values can I set on a virtual machine?
      instructions:
      - text: List supported Droplet backup policies.
      - text: Show the backup policy values virtual machines accept.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Droplet's snapshots
      effect: read
      questions:
      - What snapshots have been taken of my Droplet?
      - Can I see the snapshots of one virtual machine?
      instructions:
      - text: List snapshots for Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Show the snapshots taken of virtual machine {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: List actions on a Droplet
      effect: read
      questions:
      - What actions have been run on my Droplet?
      - Can I see the action history of one virtual machine?
      instructions:
      - text: List actions on Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Show the action history of virtual machine {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Run an action on a Droplet
      effect: write
      questions:
      - How do I reboot or power off a Droplet?
      - Can I run an action like resize on a virtual machine?
      instructions:
      - text: Run an action on Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Reboot virtual machine {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a bulk action on Droplets
      effect: write
      questions:
      - Can I reboot several Droplets at once?
      - Is there a bulk action for Droplets?
      instructions:
      - text: Run a bulk action on all my Droplets.
      - text: Reboot every virtual machine I own in one request.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/actions/{action_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Droplet action
      effect: read
      questions:
      - Has a particular action on my Droplet finished?
      - Can I check the status of one action on a virtual machine?
      instructions:
      - text: Get action {action_id} on Droplet {droplet_id}.
        slots:
          action_id: path.action_id
          droplet_id: path.droplet_id
      - text: Check the status of action {action_id} on virtual machine {droplet_id}.
        slots:
          action_id: path.action_id
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/kernels'].get
  update:
    x-apievangelist-phrasing:
      intent: List kernels available to a Droplet
      effect: read
      questions:
      - Which kernels can I boot my Droplet with?
      - What kernel options exist for a virtual machine?
      instructions:
      - text: List kernels for Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Show the kernel options available to virtual machine {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/firewalls'].get
  update:
    x-apievangelist-phrasing:
      intent: List firewalls attached to a Droplet
      effect: read
      questions:
      - Which firewalls are attached to my Droplet?
      - Can I see the firewall rules applied to a virtual machine?
      instructions:
      - text: List firewalls attached to Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Show the firewall rules applied to virtual machine {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/neighbors'].get
  update:
    x-apievangelist-phrasing:
      intent: List neighbors of a Droplet
      effect: read
      questions:
      - Which other Droplets share a host with mine?
      - Can I see the neighbors of a virtual machine?
      instructions:
      - text: List neighbors of Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Show the other virtual machines on the same host as {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/destroy_with_associated_resources'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Droplet's destroy-with-resources plan
      effect: read
      questions:
      - What would be deleted if I destroy a Droplet with its resources?
      - Can I preview the resources a Droplet's destroy-with-resources action would remove?
      instructions:
      - text: Get the destroy-with-resources plan for Droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Show what would be deleted if I destroy virtual machine {droplet_id} with its resources.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/destroy_with_associated_resources/selective'].delete
  update:
    x-apievangelist-phrasing:
      intent: Destroy a Droplet with resources selectively
      effect: destructive
      questions:
      - Can I destroy a Droplet and its resources in a controlled way?
      - Is there a selective destroy-with-resources option for a virtual machine?
      instructions:
      - text: Destroy Droplet {droplet_id} with its resources selectively.
        slots:
          droplet_id: path.droplet_id
      - text: Remove virtual machine {droplet_id} and its resources, choosing what to delete.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/destroy_with_associated_resources/dangerous'].delete
  update:
    x-apievangelist-phrasing:
      intent: Dangerously destroy a Droplet with resources
      effect: destructive
      questions:
      - Is there a dangerous destroy-with-resources option for a Droplet?
      - Can I wipe a virtual machine and its resources in one destructive call?
      instructions:
      - text: Dangerously destroy Droplet {droplet_id} with its resources.
        slots:
          droplet_id: path.droplet_id
      - text: Wipe virtual machine {droplet_id} and all its resources in one destructive call.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/destroy_with_associated_resources/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a droplet destroy with resources
      effect: read
      questions:
      - Is my droplet still being destroyed along with its snapshots and backups?
      - How do I check the status of a droplet destroy with associated resources?
      instructions:
      - text: Check the status of droplet {droplet_id} destroy with associated resources.
        slots:
          droplet_id: path.droplet_id
      - text: Tell me whether droplet {droplet_id} is still being destroyed with its resources.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/{droplet_id}/destroy_with_associated_resources/retry'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry a droplet destroy with resources
      effect: write
      questions:
      - Can I retry a droplet destroy that failed because of a network error?
      - What happens if I retry a droplet destroy with associated resources?
      instructions:
      - text: Retry the destroy with associated resources for droplet {droplet_id}.
        slots:
          droplet_id: path.droplet_id
      - text: Retry the failed droplet {droplet_id} destroy with its snapshots and backups.
        slots:
          droplet_id: path.droplet_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/autoscale'].get
  update:
    x-apievangelist-phrasing:
      intent: List autoscale pools
      effect: read
      questions:
      - Which autoscale pools exist for my droplets?
      - Can I see all droplet autoscale pools?
      instructions:
      - text: List my droplet autoscale pools.
      - text: Show every droplet autoscale pool.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/autoscale'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a droplet autoscale pool
      effect: write
      questions:
      - How do I set up autoscaling for droplets?
      - Can I create a new droplet autoscale pool?
      instructions:
      - text: Create a droplet autoscale pool.
      - text: Set up a new droplet autoscale pool.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/autoscale/{autoscale_pool_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a droplet autoscale pool
      effect: read
      questions:
      - What is the configuration of one droplet autoscale pool?
      - Can I view a single droplet autoscale pool?
      instructions:
      - text: Get droplet autoscale pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      - text: Show the configuration of droplet autoscale pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/autoscale/{autoscale_pool_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a droplet autoscale pool
      effect: write
      questions:
      - How do I replace the configuration of a droplet autoscale pool?
      - Can I overwrite a droplet autoscale pool entirely?
      instructions:
      - text: Replace droplet autoscale pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      - text: Overwrite the configuration of droplet autoscale pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/autoscale/{autoscale_pool_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a droplet autoscale pool
      effect: destructive
      questions:
      - How do I delete a droplet autoscale pool?
      - Can I remove a droplet autoscale pool I no longer use?
      instructions:
      - text: Delete droplet autoscale pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      - text: Remove droplet autoscale pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/autoscale/{autoscale_pool_id}/dangerous'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a droplet autoscale pool (dangerous)
      effect: destructive
      questions:
      - Is there a dangerous way to delete a droplet autoscale pool?
      - Can I delete a droplet autoscale pool without confirmation?
      instructions:
      - text: Delete droplet autoscale pool {autoscale_pool_id} with the dangerous flag.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      - text: Remove droplet autoscale pool {autoscale_pool_id} using the dangerous delete.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/autoscale/{autoscale_pool_id}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List members of a droplet autoscale pool
      effect: read
      questions:
      - Which droplets are in a particular autoscale pool?
      - Can I see the members of a droplet autoscale pool?
      instructions:
      - text: List the members of droplet autoscale pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      - text: Show which droplets belong to autoscale pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/droplets/autoscale/{autoscale_pool_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: Get autoscale pool history
      effect: read
      questions:
      - What autoscaling events happened in a droplet autoscale pool?
      - Can I see the autoscale history for a pool?
      instructions:
      - text: Get the autoscale history for droplet autoscale pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_id
      - text: Show autoscaling events in pool {autoscale_pool_id}.
        slots:
          autoscale_pool_id: path.autoscale_pool_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-droplets-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.