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.
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
# 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.
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.