Digital Ocean · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for DigitalOcean Vpcs API

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

$.info
$.paths['/v2/vpcs'].get
$.paths['/v2/vpcs'].post
$.paths['/v2/vpcs/{vpc_id}'].get
$.paths['/v2/vpcs/{vpc_id}'].put
$.paths['/v2/vpcs/{vpc_id}'].delete
$.paths['/v2/vpcs/{vpc_id}'].patch
$.paths['/v2/vpcs/{vpc_id}/members'].get
$.paths['/v2/vpcs/{vpc_id}/peerings'].get
$.paths['/v2/vpcs/{vpc_id}/peerings'].post
$.paths['/v2/vpcs/{vpc_id}/peerings/{vpc_peering_id}'].patch
$.paths['/v2/vpcs/{vpc_uuid}/routes'].get
$.paths['/v2/vpcs/{vpc_uuid}/subnets'].get
$.paths['/v2/vpcs/{vpc_uuid}/subnets'].post
$.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}'].get
$.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}'].delete

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 Vpcs API
  version: 1.0.0
extends: openapi/digital-ocean-vpcs-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: 21
- target: $.paths['/v2/vpcs'].get
  update:
    x-apievangelist-phrasing:
      intent: List VPCs
      effect: read
      questions:
      - Which virtual private clouds exist in my account?
      - Can I see all my VPCs at once?
      instructions:
      - text: List all my VPCs.
      - text: Show every virtual private cloud in my account.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a VPC
      effect: write
      questions:
      - How do I create a new virtual private cloud?
      - Can I set a region and size when creating a VPC?
      instructions:
      - text: Create a new VPC.
      - text: Set up a fresh virtual private cloud.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a VPC
      effect: read
      questions:
      - What are the details of one VPC?
      - Can I look up a VPC by its ID?
      instructions:
      - text: Show VPC {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      - text: Get the details of virtual private cloud {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a VPC
      effect: write
      questions:
      - Can I overwrite a VPC's settings entirely?
      - What does a full replace of a VPC do?
      instructions:
      - text: Replace VPC {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      - text: Overwrite the entire virtual private cloud {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a VPC
      effect: destructive
      questions:
      - How do I delete a VPC?
      - Can I remove a virtual private cloud I no longer need?
      instructions:
      - text: Delete VPC {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      - text: Remove virtual private cloud {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a VPC
      effect: write
      questions:
      - Can I rename a VPC or change its settings?
      - How do I edit an existing virtual private cloud?
      instructions:
      - text: Update VPC {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      - text: Rename or change the settings of virtual private cloud {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_id}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List a VPC's members
      effect: read
      questions:
      - Which resources are members of a VPC?
      - Can I see what a virtual private cloud contains?
      instructions:
      - text: Show the members of VPC {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      - text: List the resources in virtual private cloud {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_id}/peerings'].get
  update:
    x-apievangelist-phrasing:
      intent: List VPC peerings
      effect: read
      questions:
      - Which VPC peering connections exist for a VPC?
      - Can I see the peering relationships of a virtual private cloud?
      instructions:
      - text: Show the peerings of VPC {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      - text: List the VPC peering connections for virtual private cloud {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_id}/peerings'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a VPC peering connection
      effect: write
      questions:
      - How do I peer two VPCs together?
      - Can I create a VPC peering connection for a virtual private cloud?
      instructions:
      - text: Create a peering connection on VPC {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      - text: Set up a VPC peering connection for virtual private cloud {vpc_id}.
        slots:
          vpc_id: path.vpc_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_id}/peerings/{vpc_peering_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a VPC peering connection
      effect: write
      questions:
      - Can I change an existing VPC peering connection?
      - How do I edit a VPC peering relationship?
      instructions:
      - text: Update peering connection {vpc_peering_id} on VPC {vpc_id}.
        slots:
          vpc_peering_id: path.vpc_peering_id
          vpc_id: path.vpc_id
      - text: Edit VPC peering connection {vpc_peering_id} of virtual private cloud {vpc_id}.
        slots:
          vpc_peering_id: path.vpc_peering_id
          vpc_id: path.vpc_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/routes'].get
  update:
    x-apievangelist-phrasing:
      intent: List a VPC's routes
      effect: read
      questions:
      - What routes are configured on a VPC?
      - Can I see the routing table of a virtual private cloud?
      instructions:
      - text: Show the routes on VPC {vpc_uuid}.
        slots:
          vpc_uuid: path.vpc_uuid
      - text: List the routing table of virtual private cloud {vpc_uuid}.
        slots:
          vpc_uuid: path.vpc_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets'].get
  update:
    x-apievangelist-phrasing:
      intent: List a VPC's subnets
      effect: read
      questions:
      - Which subnets are in a VPC?
      - Can I see the subnets of a virtual private cloud?
      instructions:
      - text: Show the subnets of VPC {vpc_uuid}.
        slots:
          vpc_uuid: path.vpc_uuid
      - text: List the subnets in virtual private cloud {vpc_uuid}.
        slots:
          vpc_uuid: path.vpc_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a subnet in a VPC
      effect: write
      questions:
      - How do I add a subnet to a VPC?
      - Can I create a new subnet inside a virtual private cloud?
      instructions:
      - text: Create a subnet in VPC {vpc_uuid}.
        slots:
          vpc_uuid: path.vpc_uuid
      - text: Add a new subnet to virtual private cloud {vpc_uuid}.
        slots:
          vpc_uuid: path.vpc_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one subnet on a VPC
      effect: read
      questions:
      - What are the details of a subnet inside a VPC?
      - Can I look up a single subnet by its UUID?
      instructions:
      - text: Get subnet {subnet} on VPC {vpc}.
        slots:
          subnet: path.subnet_uuid
          vpc: path.vpc_uuid
      - text: Show details of VPC subnet {subnet} in {vpc}.
        slots:
          subnet: path.subnet_uuid
          vpc: path.vpc_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a VPC subnet
      effect: destructive
      questions:
      - How do I delete a subnet from a VPC?
      - Can I remove a subnet I no longer need?
      instructions:
      - text: Delete subnet {subnet_uuid} from VPC {vpc_uuid}.
        slots:
          subnet_uuid: path.subnet_uuid
          vpc_uuid: path.vpc_uuid
      - text: Remove subnet {subnet_uuid} in virtual private cloud {vpc_uuid}.
        slots:
          subnet_uuid: path.subnet_uuid
          vpc_uuid: path.vpc_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a subnet on a VPC
      effect: write
      questions:
      - Can I rename a subnet inside a VPC?
      - What's the way to update a VPC subnet's settings?
      instructions:
      - text: Rename VPC subnet {subnet} in {vpc}.
        slots:
          subnet: path.subnet_uuid
          vpc: path.vpc_uuid
      - text: Update the settings of subnet {subnet} on VPC {vpc}.
        slots:
          subnet: path.subnet_uuid
          vpc: path.vpc_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List members of a VPC subnet
      effect: read
      questions:
      - Which load balancers and droplets live in a subnet?
      - Who are the members of this VPC subnet?
      instructions:
      - text: List members of subnet {subnet} on VPC {vpc}.
        slots:
          subnet: path.subnet_uuid
          vpc: path.vpc_uuid
      - text: Show the load balancers and droplets in VPC subnet {subnet}.
        slots:
          subnet: path.subnet_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}/routes'].get
  update:
    x-apievangelist-phrasing:
      intent: List routes on a VPC subnet
      effect: read
      questions:
      - Which custom routes exist on a VPC subnet?
      - What destinations does a subnet route to?
      instructions:
      - text: List routes on subnet {subnet} of VPC {vpc}.
        slots:
          subnet: path.subnet_uuid
          vpc: path.vpc_uuid
      - text: Show custom routes for VPC subnet {subnet}.
        slots:
          subnet: path.subnet_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}/routes'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a custom route to a VPC subnet
      effect: write
      questions:
      - Can I add a custom route to a subnet?
      - How do I route traffic for a VPC CIDR through a subnet?
      instructions:
      - text: Add a route to subnet {subnet} on VPC {vpc}.
        slots:
          subnet: path.subnet_uuid
          vpc: path.vpc_uuid
      - text: Create a custom route in VPC subnet {subnet}.
        slots:
          subnet: path.subnet_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}/routes/{route_uuid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom route from a VPC subnet
      effect: destructive
      questions:
      - Can I remove a custom route from a VPC subnet?
      - What's the way to delete one subnet route?
      instructions:
      - text: Delete route {route} from subnet {subnet} on VPC {vpc}.
        slots:
          route: path.route_uuid
          subnet: path.subnet_uuid
          vpc: path.vpc_uuid
      - text: Remove custom route {route} from VPC subnet {subnet}.
        slots:
          route: path.route_uuid
          subnet: path.subnet_uuid
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/vpcs/{vpc_uuid}/subnets/{subnet_uuid}/routes/{route_uuid}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a route in a VPC subnet
      effect: write
      questions:
      - How do I change the destination of a route in a VPC subnet?
      - Can I edit a custom route on a subnet?
      instructions:
      - text: Update route {route_uuid} in subnet {subnet_uuid} of VPC {vpc_uuid}.
        slots:
          route_uuid: path.route_uuid
          subnet_uuid: path.subnet_uuid
          vpc_uuid: path.vpc_uuid
      - text: Change the destination of route {route_uuid} on subnet {subnet_uuid} in VPC {vpc_uuid}.
        slots:
          route_uuid: path.route_uuid
          subnet_uuid: path.subnet_uuid
          vpc_uuid: path.vpc_uuid
      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-vpcs-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.