Digital Ocean · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for DigitalOcean Registries API
20 actions
20 updates
phrasing
extends
openapi/digital-ocean-registries-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 20 · first 16 shown; the file carries all of them
$.info
$.paths['/v2/registries'].get
$.paths['/v2/registries'].post
$.paths['/v2/registries/{registry_name}'].get
$.paths['/v2/registries/{registry_name}'].delete
$.paths['/v2/registries/{registry_name}/docker-credentials'].get
$.paths['/v2/registries/subscription'].get
$.paths['/v2/registries/subscription'].post
$.paths['/v2/registries/options'].get
$.paths['/v2/registries/{registry_name}/garbage-collection'].get
$.paths['/v2/registries/{registry_name}/garbage-collection'].post
$.paths['/v2/registries/{registry_name}/garbage-collections'].get
$.paths['/v2/registries/{registry_name}/garbage-collection/{garbage_collection_uuid}'].put
$.paths['/v2/registries/{registry_name}/repositoriesV2'].get
$.paths['/v2/registries/{registry_name}/repositories/{repository_name}'].delete
$.paths['/v2/registries/{registry_name}/repositories/{repository_name}/tags'].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 Registries API
version: 1.0.0
extends: openapi/digital-ocean-registries-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: 19
- target: $.paths['/v2/registries'].get
update:
x-apievangelist-phrasing:
intent: List container registries
effect: read
questions:
- Which container registries do I have?
- Can I see all my Docker registries at once?
instructions:
- text: List all my container registries.
- text: Show every registry in my account.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries'].post
update:
x-apievangelist-phrasing:
intent: Create a container registry
effect: write
questions:
- How do I create a new container registry?
- Can I set up a private registry for my images?
instructions:
- text: Create a new container registry.
- text: Set up a private registry for my Docker images.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}'].get
update:
x-apievangelist-phrasing:
intent: Get a container registry
effect: read
questions:
- What are the details of one registry?
- Can I look up a registry by its name?
instructions:
- text: Get registry {registry_name}.
slots:
registry_name: path.registry_name
- text: Show the details of registry {registry_name}.
slots:
registry_name: path.registry_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a container registry
effect: destructive
questions:
- How do I delete a registry?
- Can I remove a container registry I no longer use?
instructions:
- text: Delete registry {registry_name}.
slots:
registry_name: path.registry_name
- text: Remove the registry {registry_name}.
slots:
registry_name: path.registry_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/docker-credentials'].get
update:
x-apievangelist-phrasing:
intent: Get Docker credentials for a registry
effect: read
questions:
- How do I get Docker credentials for a registry?
- Can I pull images from a registry with its credentials?
instructions:
- text: Get Docker credentials for registry {registry_name}.
slots:
registry_name: path.registry_name
- text: Show the credentials I need to pull from {registry_name}.
slots:
registry_name: path.registry_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/subscription'].get
update:
x-apievangelist-phrasing:
intent: Get the registry subscription
effect: read
questions:
- What registry subscription is my account on?
- Can I check my registry plan details?
instructions:
- text: Get my registry subscription.
- text: Show which registry plan my account has.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/subscription'].post
update:
x-apievangelist-phrasing:
intent: Subscribe to a registry plan
effect: write
questions:
- How do I upgrade my registry subscription?
- Can I change my registry plan?
instructions:
- text: Subscribe to a new registry plan.
- text: Upgrade my registry subscription.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/options'].get
update:
x-apievangelist-phrasing:
intent: Get registry options
effect: read
questions:
- What registry options are available?
- Can I see the registry settings I can choose from?
instructions:
- text: Get the registry options.
- text: Show registry settings I can pick from.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/garbage-collection'].get
update:
x-apievangelist-phrasing:
intent: Get a registry's garbage collection job
effect: read
questions:
- What garbage collection job is running on a registry?
- Can I see the details of one registry garbage collection job?
instructions:
- text: Get the garbage collection job for registry {registry_name}.
slots:
registry_name: path.registry_name
- text: Show registry {registry_name}'s garbage collection job.
slots:
registry_name: path.registry_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/garbage-collection'].post
update:
x-apievangelist-phrasing:
intent: Start a registry garbage collection job
effect: write
questions:
- How do I clean up unused images on a registry?
- Can I trigger garbage collection on a registry?
instructions:
- text: Start a garbage collection job on registry {registry_name}.
slots:
registry_name: path.registry_name
- text: Clean up unused images on registry {registry_name}.
slots:
registry_name: path.registry_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/garbage-collections'].get
update:
x-apievangelist-phrasing:
intent: List a registry's garbage collection jobs
effect: read
questions:
- Which garbage collection jobs have run on a registry?
- Can I see the history of registry garbage collection jobs?
instructions:
- text: List garbage collection jobs for registry {registry_name}.
slots:
registry_name: path.registry_name
- text: Show the registry {registry_name} garbage collection history.
slots:
registry_name: path.registry_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/garbage-collection/{garbage_collection_uuid}'].put
update:
x-apievangelist-phrasing:
intent: Replace a registry garbage collection job
effect: write
questions:
- Can I update an existing registry garbage collection job?
- How do I edit a registry garbage collection job?
instructions:
- text: Replace garbage collection job {garbage_collection_uuid} on registry {registry_name}.
slots:
garbage_collection_uuid: path.garbage_collection_uuid
registry_name: path.registry_name
- text: Update registry {registry_name}'s garbage collection job {garbage_collection_uuid}.
slots:
registry_name: path.registry_name
garbage_collection_uuid: path.garbage_collection_uuid
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/repositoriesV2'].get
update:
x-apievangelist-phrasing:
intent: List a registry's repositories
effect: read
questions:
- Which repositories are in a registry?
- Can I list the repositories of one registry?
instructions:
- text: List repositories in registry {registry_name}.
slots:
registry_name: path.registry_name
- text: Show every repository under registry {registry_name}.
slots:
registry_name: path.registry_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/repositories/{repository_name}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a repository from a registry
effect: destructive
questions:
- How do I delete a repository from a registry?
- Can I remove a single registry repository?
instructions:
- text: Delete repository {repository_name} from registry {registry_name}.
slots:
repository_name: path.repository_name
registry_name: path.registry_name
- text: Remove registry {registry_name}'s repository {repository_name}.
slots:
registry_name: path.registry_name
repository_name: path.repository_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/repositories/{repository_name}/tags'].get
update:
x-apievangelist-phrasing:
intent: List tags in a registry repository
effect: read
questions:
- Which tags exist in a registry repository?
- Can I see the image tags of one repository?
instructions:
- text: List tags in repository {repository_name} of registry {registry_name}.
slots:
repository_name: path.repository_name
registry_name: path.registry_name
- text: Show the image tags of registry {registry_name}'s {repository_name}.
slots:
registry_name: path.registry_name
repository_name: path.repository_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/repositories/{repository_name}/tags/{repository_tag}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a tag from a registry repository
effect: destructive
questions:
- How do I delete a single tag from a registry repository?
- Can I remove one image tag from a registry repository?
instructions:
- text: Delete tag {repository_tag} from repository {repository_name} in registry {registry_name}.
slots:
repository_tag: path.repository_tag
repository_name: path.repository_name
registry_name: path.registry_name
- text: Remove registry {registry_name}'s {repository_name} tag {repository_tag}.
slots:
registry_name: path.registry_name
repository_name: path.repository_name
repository_tag: path.repository_tag
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/repositories/{repository_name}/digests'].get
update:
x-apievangelist-phrasing:
intent: List manifests in a registry repository
effect: read
questions:
- Which manifests are in a registry repository?
- Can I see the digest list of one repository?
instructions:
- text: List manifests in repository {repository_name} of registry {registry_name}.
slots:
repository_name: path.repository_name
registry_name: path.registry_name
- text: Show the digest list of registry {registry_name}'s {repository_name}.
slots:
registry_name: path.registry_name
repository_name: path.repository_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/{registry_name}/repositories/{repository_name}/digests/{manifest_digest}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a registry manifest digest
effect: destructive
questions:
- How do I remove a specific image manifest digest from a registry?
- Can I delete one digest by its digest value?
instructions:
- text: Delete digest {manifest_digest} from registry {registry_name} repository {repository_name}.
slots:
manifest_digest: path.manifest_digest
registry_name: path.registry_name
repository_name: path.repository_name
- text: Remove the image digest {manifest_digest} from {registry_name}/{repository_name}.
slots:
manifest_digest: path.manifest_digest
registry_name: path.registry_name
repository_name: path.repository_name
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/registries/validate-name'].post
update:
x-apievangelist-phrasing:
intent: Check if a registry name is available
effect: read
questions:
- Is a registry name already taken?
- Can I validate a registry name before creating it?
instructions:
- text: Validate the registry name.
- text: Check whether a registry name is available.
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-registries-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.