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

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

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

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.