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.
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
# 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.
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.