Digital Ocean · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for DigitalOcean Images API
14 actions
14 updates
phrasing
extends
openapi/digital-ocean-images-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 14
$.info
$.paths['/v2/images'].get
$.paths['/v2/images'].post
$.paths['/v2/images/{image_id}'].get
$.paths['/v2/images/{image_id}'].put
$.paths['/v2/images/{image_id}'].delete
$.paths['/v2/images/{image_id}/account_transfer'].post
$.paths['/v2/images/{image_id}/account_transfer/accept'].post
$.paths['/v2/images/{image_id}/account_transfer/cancel'].post
$.paths['/v2/images/{image_id}/account_transfer/decline'].post
$.paths['/v2/images/{image_id}/actions'].get
$.paths['/v2/images/{image_id}/actions'].post
$.paths['/v2/images/{image_id}/actions/{action_id}'].get
$.paths['/v1/images/generations'].post
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 Images API
version: 1.0.0
extends: openapi/digital-ocean-images-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: 13
- target: $.paths['/v2/images'].get
update:
x-apievangelist-phrasing:
intent: List images
effect: read
questions:
- What images are available to create Droplets from?
- Can I see all my custom and public images?
instructions:
- text: List all images.
- text: Show every image I can use to launch a Droplet.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images'].post
update:
x-apievangelist-phrasing:
intent: Create an image from a Droplet
effect: write
questions:
- How do I save a Droplet as a reusable image?
- Can I create a custom image from a Droplet I'm done with?
instructions:
- text: Create an image from my Droplet.
- text: Save this Droplet as a new image.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}'].get
update:
x-apievangelist-phrasing:
intent: Get an image
effect: read
questions:
- What is the name and type of a specific image?
- Can I look up one image by its ID?
instructions:
- text: Get image {image_id}.
slots:
image_id: path.image_id
- text: Show the details of image {image_id}.
slots:
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}'].put
update:
x-apievangelist-phrasing:
intent: Replace an image
effect: write
questions:
- Can I overwrite an image's details?
- What does replacing an image do?
instructions:
- text: Replace image {image_id}.
slots:
image_id: path.image_id
- text: Overwrite the details of image {image_id}.
slots:
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an image
effect: destructive
questions:
- How do I delete an image I no longer need?
- Can I remove a custom image?
instructions:
- text: Delete image {image_id}.
slots:
image_id: path.image_id
- text: Remove the image {image_id} permanently.
slots:
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}/account_transfer'].post
update:
x-apievangelist-phrasing:
intent: Transfer an image to another account
effect: write
questions:
- How do I share an image with a user on a different account?
- Can I transfer a custom image to another account?
instructions:
- text: Transfer image {image_id} to another account.
slots:
image_id: path.image_id
- text: Share my image {image_id} with a user on a different account.
slots:
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}/account_transfer/accept'].post
update:
x-apievangelist-phrasing:
intent: Accept an image transfer
effect: write
questions:
- How do I accept an image transfer from another account?
- What happens when I accept a shared image?
instructions:
- text: Accept the image transfer for image {image_id}.
slots:
image_id: path.image_id
- text: Confirm I want image {image_id} from the other account.
slots:
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}/account_transfer/cancel'].post
update:
x-apievangelist-phrasing:
intent: Cancel an image transfer
effect: destructive
questions:
- Can I stop an image transfer I started?
- How do I cancel a transfer of an image?
instructions:
- text: Cancel the image transfer for image {image_id}.
slots:
image_id: path.image_id
- text: Stop sharing image {image_id}.
slots:
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}/account_transfer/decline'].post
update:
x-apievangelist-phrasing:
intent: Decline an image transfer
effect: destructive
questions:
- How do I refuse an image transfer from another account?
- Can I decline a shared image?
instructions:
- text: Decline the image transfer for image {image_id}.
slots:
image_id: path.image_id
- text: Refuse the shared image {image_id}.
slots:
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}/actions'].get
update:
x-apievangelist-phrasing:
intent: List actions on an image
effect: read
questions:
- What actions have been run on an image?
- Can I see the action history for an image?
instructions:
- text: List actions on image {image_id}.
slots:
image_id: path.image_id
- text: Show the action history for image {image_id}.
slots:
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}/actions'].post
update:
x-apievangelist-phrasing:
intent: Run an action on an image
effect: write
questions:
- Can I rebuild an image or resize it through an action?
- What actions can I run on an image?
instructions:
- text: Run an action on image {image_id}.
slots:
image_id: path.image_id
- text: Queue a new action for image {image_id}.
slots:
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/images/{image_id}/actions/{action_id}'].get
update:
x-apievangelist-phrasing:
intent: Get an action on an image
effect: read
questions:
- What is the status of a specific action on an image?
- Can I check one image action by its ID?
instructions:
- text: Get action {action_id} on image {image_id}.
slots:
action_id: path.action_id
image_id: path.image_id
- text: Show the progress of action {action_id} for image {image_id}.
slots:
action_id: path.action_id
image_id: path.image_id
method: generated
generated: '2026-11-18'
- target: $.paths['/v1/images/generations'].post
update:
x-apievangelist-phrasing:
intent: Generate images from a Droplet
effect: write
questions:
- How do I generate a new image from a Droplet's current state?
- Can I create an image generation for a Droplet?
instructions:
- text: Generate a new image from my Droplet.
- text: Create an image generation for this Droplet.
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-images-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.