Digital Ocean · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for DigitalOcean Action Gateway API

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

$.info
$.paths['/v2/action-gateway/actors/{actor_id}/limits'].get
$.paths['/v2/action-gateway/actors/{actor_id}/limits:clear'].post
$.paths['/v2/action-gateway/actors/{actor_id}/limits:set'].post
$.paths['/v2/action-gateway/connections'].get
$.paths['/v2/action-gateway/connections'].post
$.paths['/v2/action-gateway/connections/{id}'].get
$.paths['/v2/action-gateway/connections/{id}'].delete
$.paths['/v2/action-gateway/mcp-servers'].get
$.paths['/v2/action-gateway/mcp-servers'].post
$.paths['/v2/action-gateway/mcp-servers/{server_ref}'].get
$.paths['/v2/action-gateway/mcp-servers/{server_ref}'].delete
$.paths['/v2/action-gateway/mcp-servers/{server_ref}'].patch
$.paths['/v2/action-gateway/mcp-servers/{server_ref}/resync'].post
$.paths['/v2/action-gateway/mcp-servers/{server_ref}/tools'].get
$.paths['/v2/action-gateway/mcp-servers/{server_ref}/tools'].put

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 Action Gateway API
  version: 1.0.0
extends: openapi/digital-ocean-action-gateway-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: 43
- target: $.paths['/v2/action-gateway/actors/{actor_id}/limits'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an actor's action gateway limits
      effect: read
      questions:
      - What limits are set on an action gateway actor?
      - Can I see the usage limits for a specific actor?
      instructions:
      - text: Show the limits for action gateway actor {actor_id}.
        slots:
          actor_id: path.actor_id
      - text: Get the usage limits of actor {actor_id}.
        slots:
          actor_id: path.actor_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/actors/{actor_id}/limits:clear'].post
  update:
    x-apievangelist-phrasing:
      intent: Clear an actor's action gateway limits
      effect: destructive
      questions:
      - How do I reset an actor's action gateway limits to zero?
      - Can I clear all limits on an actor?
      instructions:
      - text: Clear the limits for action gateway actor {actor_id}.
        slots:
          actor_id: path.actor_id
      - text: Reset every limit on actor {actor_id} to zero.
        slots:
          actor_id: path.actor_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/actors/{actor_id}/limits:set'].post
  update:
    x-apievangelist-phrasing:
      intent: Set an actor's action gateway limits
      effect: write
      questions:
      - Can I cap how much an action gateway actor can use?
      - How do I set new limits on an actor?
      instructions:
      - text: Set limits on action gateway actor {actor_id}.
        slots:
          actor_id: path.actor_id
      - text: Cap the usage of actor {actor_id}.
        slots:
          actor_id: path.actor_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List action gateway connections
      effect: read
      questions:
      - Which action gateway connections are configured?
      - What connections are set up for the action gateway?
      instructions:
      - text: List all action gateway connections.
      - text: Show every action gateway connection.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/connections'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an action gateway connection
      effect: write
      questions:
      - How do I add a new connection to the action gateway?
      - Can I create a connection for an MCP server?
      instructions:
      - text: Create an action gateway connection.
      - text: Add a new connection to the action gateway.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/connections/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an action gateway connection
      effect: read
      questions:
      - What are the details of one action gateway connection?
      - Can I look up a single action gateway connection by ID?
      instructions:
      - text: Get action gateway connection {id}.
        slots:
          id: path.id
      - text: Show the details of connection {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/connections/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an action gateway connection
      effect: destructive
      questions:
      - How do I remove a connection from the action gateway?
      - Can I delete an action gateway connection?
      instructions:
      - text: Delete action gateway connection {id}.
        slots:
          id: path.id
      - text: Remove connection {id} from the action gateway.
        slots:
          id: path.id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/mcp-servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List action gateway MCP servers
      effect: read
      questions:
      - Which MCP servers are registered with the action gateway?
      - What remote MCP servers are enabled?
      instructions:
      - text: List all action gateway MCP servers.
      - text: Show every registered MCP server.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/mcp-servers'].post
  update:
    x-apievangelist-phrasing:
      intent: Register an MCP server with the action gateway
      effect: write
      questions:
      - How do I register a remote MCP server with the action gateway?
      - Can I add a new MCP server reference?
      instructions:
      - text: Register a new MCP server with the action gateway.
      - text: Add a remote MCP server to the action gateway.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/mcp-servers/{server_ref}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an MCP server's details
      effect: read
      questions:
      - What is the status of one MCP server?
      - Can I look up an MCP server by its reference?
      instructions:
      - text: Get MCP server {server_ref}.
        slots:
          server_ref: path.server_ref
      - text: Show the details of MCP server {server_ref}.
        slots:
          server_ref: path.server_ref
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/mcp-servers/{server_ref}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unregister an MCP server
      effect: destructive
      questions:
      - How do I remove an MCP server from the action gateway?
      - Can I unregister a remote MCP server?
      instructions:
      - text: Unregister MCP server {server_ref}.
        slots:
          server_ref: path.server_ref
      - text: Remove MCP server {server_ref} from the action gateway.
        slots:
          server_ref: path.server_ref
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/mcp-servers/{server_ref}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an MCP server
      effect: write
      questions:
      - Can I change the settings of an MCP server?
      - How do I edit an existing MCP server reference?
      instructions:
      - text: Update MCP server {server_ref}.
        slots:
          server_ref: path.server_ref
      - text: Edit the configuration of MCP server {server_ref}.
        slots:
          server_ref: path.server_ref
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/mcp-servers/{server_ref}/resync'].post
  update:
    x-apievangelist-phrasing:
      intent: Resync an MCP server's tools
      effect: write
      questions:
      - How do I refresh the tool list from an MCP server?
      - Can I force an MCP server to resync its tools?
      instructions:
      - text: Resync the tools of MCP server {server_ref}.
        slots:
          server_ref: path.server_ref
      - text: Force MCP server {server_ref} to refresh its tool list.
        slots:
          server_ref: path.server_ref
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/mcp-servers/{server_ref}/tools'].get
  update:
    x-apievangelist-phrasing:
      intent: List an MCP server's tools
      effect: read
      questions:
      - Which tools does an MCP server expose?
      - Can I see the tool list for one MCP server?
      instructions:
      - text: List the tools of MCP server {server_ref}.
        slots:
          server_ref: path.server_ref
      - text: Show which tools server {server_ref} provides.
        slots:
          server_ref: path.server_ref
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/mcp-servers/{server_ref}/tools'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an MCP server's tools
      effect: write
      questions:
      - Can I overwrite the tool list an MCP server exposes?
      - How do I set exactly which tools a server provides?
      instructions:
      - text: Replace the tools of MCP server {server_ref}.
        slots:
          server_ref: path.server_ref
      - text: Set the tool list for server {server_ref} to this exact list.
        slots:
          server_ref: path.server_ref
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/output-views'].get
  update:
    x-apievangelist-phrasing:
      intent: List action gateway output views
      effect: read
      questions:
      - What output views are defined for the action gateway?
      - Which output views exist?
      instructions:
      - text: List all action gateway output views.
      - text: Show every output view.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/output-views'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an output view
      effect: write
      questions:
      - How do I define a new output view for the action gateway?
      - Can I create an output view to reshape tool output?
      instructions:
      - text: Create an output view.
      - text: Add a new output view to the action gateway.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/output-views/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview an output view
      effect: read
      questions:
      - Can I test how an output view reshapes tool output before saving it?
      - What would an output view look like on a sample result?
      instructions:
      - text: Preview this output view.
      - text: Show what the output view would return for a sample result.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/output-views/{view_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an output view
      effect: read
      questions:
      - What does one output view define?
      - Can I look up an output view by ID?
      instructions:
      - text: Get output view {view_id}.
        slots:
          view_id: path.view_id
      - text: Show the definition of output view {view_id}.
        slots:
          view_id: path.view_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/output-views/{view_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an output view
      effect: destructive
      questions:
      - How do I remove an output view?
      - Can I delete an output view I no longer need?
      instructions:
      - text: Delete output view {view_id}.
        slots:
          view_id: path.view_id
      - text: Remove output view {view_id} from the action gateway.
        slots:
          view_id: path.view_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/sessions'].get
  update:
    x-apievangelist-phrasing:
      intent: List action gateway sessions
      effect: read
      questions:
      - Which agent sessions are currently open in my action gateway?
      - Can I see all the sessions my team is running?
      instructions:
      - text: List my action gateway sessions.
      - text: Show every session in the action gateway.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/sessions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an action gateway session
      effect: write
      questions:
      - How do I open a new session for an agent to run actions?
      - Can I create a fresh action gateway session for a team member?
      instructions:
      - text: Create a new action gateway session.
      - text: Open a session so an agent can run actions.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/sessions/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search action gateway sessions
      effect: read
      questions:
      - Can I search my action gateway sessions by name?
      - What sessions match a search query in the action gateway?
      instructions:
      - text: Search my action gateway sessions.
      - text: Find sessions in the action gateway matching a query.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/sessions/{session_urn}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an action gateway session
      effect: destructive
      questions:
      - How do I close and delete an action gateway session?
      - Can I remove a session by its URN?
      instructions:
      - text: Delete action gateway session {session_urn}.
        slots:
          session_urn: path.session_urn
      - text: Close the session {session_urn} in the action gateway.
        slots:
          session_urn: path.session_urn
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/toolbelts'].get
  update:
    x-apievangelist-phrasing:
      intent: List action gateway toolbelts
      effect: read
      questions:
      - What toolbelts are available in my action gateway?
      - Can I see every toolbelt my team owns?
      instructions:
      - text: List my action gateway toolbelts.
      - text: Show all toolbelts in the action gateway.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/toolbelts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an action gateway toolbelt
      effect: write
      questions:
      - How do I create a new toolbelt for my team?
      - Can I add a toolbelt to the action gateway?
      instructions:
      - text: Create a new action gateway toolbelt.
      - text: Add a toolbelt so sessions can reference it.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/toolbelts/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search action gateway toolbelts
      effect: read
      questions:
      - Can I search toolbelts in the action gateway?
      - Which toolbelts match a search term?
      instructions:
      - text: Search my action gateway toolbelts.
      - text: Find toolbelts in the action gateway by name.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/toolbelts/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an action gateway toolbelt
      effect: read
      questions:
      - How do I view one toolbelt's details?
      - Can I look up a toolbelt by name?
      instructions:
      - text: Get action gateway toolbelt {name}.
        slots:
          name: path.name
      - text: Show the toolbelt {name} in the action gateway.
        slots:
          name: path.name
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/toolbelts/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an action gateway toolbelt
      effect: destructive
      questions:
      - How do I delete a toolbelt I no longer need?
      - Can I remove a toolbelt by name?
      instructions:
      - text: Delete action gateway toolbelt {name}.
        slots:
          name: path.name
      - text: Remove the toolbelt {name} from the action gateway.
        slots:
          name: path.name
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/toolbelts/{name}/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: List providers in a toolbelt
      effect: read
      questions:
      - Which providers are included in a toolbelt?
      - Can I see every provider in a toolbelt?
      instructions:
      - text: List the providers in toolbelt {name}.
        slots:
          name: path.name
      - text: Show which providers {name} contains.
        slots:
          name: path.name
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/toolbelts/{name}/providers/{provider}/tools'].get
  update:
    x-apievangelist-phrasing:
      intent: List tools from one provider in a toolbelt
      effect: read
      questions:
      - What tools does a single provider offer in a toolbelt?
      - Can I list only one provider's tools in a toolbelt?
      instructions:
      - text: List the tools from provider {provider} in toolbelt {name}.
        slots:
          provider: path.provider
          name: path.name
      - text: Show only {provider} tools in toolbelt {name}.
        slots:
          provider: path.provider
          name: path.name
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/toolbelts/{name}/tools/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Add tools to a toolbelt
      effect: write
      questions:
      - How do I add tools to an existing toolbelt?
      - Can I grow a toolbelt by including more tools?
      instructions:
      - text: Add tools to toolbelt {name}.
        slots:
          name: path.name
      - text: Grow the toolbelt {name} with more tools.
        slots:
          name: path.name
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/toolbelts/{name}/tools/remove'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove tools from a toolbelt
      effect: write
      questions:
      - How do I take tools out of a toolbelt?
      - Can I shrink a toolbelt by removing tools?
      instructions:
      - text: Remove tools from toolbelt {name}.
        slots:
          name: path.name
      - text: Shrink the toolbelt {name} by removing tools.
        slots:
          name: path.name
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/tools'].get
  update:
    x-apievangelist-phrasing:
      intent: List action gateway tools
      effect: read
      questions:
      - What tools are available in the action gateway?
      - Can I see every tool the gateway knows about?
      instructions:
      - text: List all action gateway tools.
      - text: Show every tool the gateway can call.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/tools/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check action gateway tool health
      effect: read
      questions:
      - Are the tools in my action gateway healthy?
      - Can I check the overall health of every gateway tool?
      instructions:
      - text: Check the health of all action gateway tools.
      - text: Report whether every gateway tool is healthy.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/tools/health/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: Check action gateway tool health per provider
      effect: read
      questions:
      - Which providers have tools that are down?
      - Can I see tool health grouped by provider?
      instructions:
      - text: Check action gateway tool health per provider.
      - text: Show health for each provider's tools.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/tools/health/tools/{tool_slug}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check one tool's health
      effect: read
      questions:
      - Is a specific tool in the action gateway working?
      - Can I check the health of one tool by its slug?
      instructions:
      - text: Check the health of tool {tool_slug}.
        slots:
          tool_slug: path.tool_slug
      - text: Tell me whether {tool_slug} is healthy.
        slots:
          tool_slug: path.tool_slug
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/tools/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: List action gateway tool providers
      effect: read
      questions:
      - Which tool providers are registered in the action gateway?
      - Can I see all the providers that offer tools?
      instructions:
      - text: List action gateway tool providers.
      - text: Show every provider that offers tools.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/tools/providers/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search action gateway tool providers
      effect: read
      questions:
      - Can I search the tool providers in the action gateway?
      - Which provider offers a particular tool?
      instructions:
      - text: Search action gateway tool providers.
      - text: Find a provider in the action gateway by name.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/tools/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search action gateway tools
      effect: read
      questions:
      - Can I search the tools available in the action gateway?
      - What tools match a keyword in the gateway?
      instructions:
      - text: Search action gateway tools.
      - text: Find tools in the action gateway by keyword.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/tools/toolkits'].get
  update:
    x-apievangelist-phrasing:
      intent: List the action gateway toolkits
      effect: read
      questions:
      - Which toolkits are available to my agent sessions?
      - Can I browse the action gateway's tool catalog?
      instructions:
      - text: List the action gateway toolkits.
      - text: Show the available toolkits for my sessions.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List action gateway users
      effect: read
      questions:
      - Who has access to the action gateway?
      - Can I see every user in the action gateway?
      instructions:
      - text: List all action gateway users.
      - text: Show every user with action gateway access.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/action-gateway/users/{user_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an action gateway user
      effect: read
      questions:
      - Can I look up one action gateway user by ID?
      - What details are stored for a single action gateway user?
      instructions:
      - text: Get action gateway user {user_id}.
        slots:
          user_id: path.user_id
      - text: Show the record for action gateway user {user_id}.
        slots:
          user_id: path.user_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.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/digital-ocean-action-gateway-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.