# Digital Ocean Action Gateway API

**Canonical:** https://apis.io/apis/digital-ocean/digital-ocean-action-gateway-api/  
**Provider:** Digital Ocean — https://apis.io/providers/digital-ocean/  
**Base URL:** https://api.digitalocean.com  
**Documentation:** https://docs.digitalocean.com/reference/api/api-reference/

Digital Ocean Action Gateway API is one of 63 APIs that [Digital Ocean](https://apis.io/providers/digital-ocean/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Action Gateway. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Action Gateway gives AI agents governed access to tools over the Model Context Protocol (MCP). The `/v2/action-gateway` endpoints manage the tool catalog and the resources that control how agents use it: - **Tools** browse and search the catalog, its providers, and global provider and tool health. - **Toolbelts** are versioned, team-owned sets of tools that sessions and policies reference as `toolbelt:<name>@<version>`. - **Output views** reshape a tool's output before it reaches the agent. - **MCP servers** register your own remote MCP servers and choose which of their tools to enable. - **Connections** authorize one of your end users to use a provider's tools, for example through OAuth. - **Sessions** bind a tool selection and permission policy to an MCP URL that an agent connects to. - **Users** and **end user limits** show and limit activity per end user, identified by a session's `actorId`. To find and call tools in a session, use the [Action Gateway Data Plane](#tag/Action-Gateway-Data-Plane) endpoints or connect an MCP client to the session's `mcpUrl`.

## Operations (43)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/action-gateway/actors/{actor_id}/limits` | Get action gateway actors by actor id limits |
| POST | `/v2/action-gateway/actors/{actor_id}/limits:clear` | Create action gateway actors by actor id limits:clear |
| POST | `/v2/action-gateway/actors/{actor_id}/limits:set` | Create action gateway actors by actor id limits:set |
| POST | `/v2/action-gateway/connections` | Create action gateway connections |
| GET | `/v2/action-gateway/connections` | Get action gateway connections |
| GET | `/v2/action-gateway/connections/{id}` | Get action gateway connections by id |
| DELETE | `/v2/action-gateway/connections/{id}` | Delete action gateway connections by id |
| POST | `/v2/action-gateway/mcp-servers` | Create action gateway mcp servers |
| GET | `/v2/action-gateway/mcp-servers` | Get action gateway mcp servers |
| GET | `/v2/action-gateway/mcp-servers/{server_ref}` | Get action gateway mcp servers by server ref |
| PATCH | `/v2/action-gateway/mcp-servers/{server_ref}` | Update action gateway mcp servers by server ref |
| DELETE | `/v2/action-gateway/mcp-servers/{server_ref}` | Delete action gateway mcp servers by server ref |
| POST | `/v2/action-gateway/mcp-servers/{server_ref}/resync` | Create action gateway mcp servers by server ref resync |
| GET | `/v2/action-gateway/mcp-servers/{server_ref}/tools` | Get action gateway mcp servers by server ref tools |
| PUT | `/v2/action-gateway/mcp-servers/{server_ref}/tools` | Replace action gateway mcp servers by server ref tools |
| POST | `/v2/action-gateway/output-views` | Create action gateway output views |
| GET | `/v2/action-gateway/output-views` | Get action gateway output views |
| POST | `/v2/action-gateway/output-views/preview` | Create action gateway output views preview |
| GET | `/v2/action-gateway/output-views/{view_id}` | Get action gateway output views by view id |
| DELETE | `/v2/action-gateway/output-views/{view_id}` | Delete action gateway output views by view id |
| POST | `/v2/action-gateway/sessions` | Create action gateway sessions |
| GET | `/v2/action-gateway/sessions` | Get action gateway sessions |
| GET | `/v2/action-gateway/sessions/search` | Get action gateway sessions search |
| DELETE | `/v2/action-gateway/sessions/{session_urn}` | Delete action gateway sessions by session urn |
| POST | `/v2/action-gateway/toolbelts` | Create action gateway toolbelts |
| GET | `/v2/action-gateway/toolbelts` | Get action gateway toolbelts |
| GET | `/v2/action-gateway/toolbelts/search` | Get action gateway toolbelts search |
| GET | `/v2/action-gateway/toolbelts/{name}` | Get action gateway toolbelts by name |
| DELETE | `/v2/action-gateway/toolbelts/{name}` | Delete action gateway toolbelts by name |
| GET | `/v2/action-gateway/toolbelts/{name}/providers` | Get action gateway toolbelts by name providers |
| GET | `/v2/action-gateway/toolbelts/{name}/providers/{provider}/tools` | Get action gateway toolbelts by name providers by provider tools |
| POST | `/v2/action-gateway/toolbelts/{name}/tools/add` | Create action gateway toolbelts by name tools add |
| POST | `/v2/action-gateway/toolbelts/{name}/tools/remove` | Create action gateway toolbelts by name tools remove |
| GET | `/v2/action-gateway/tools` | Get action gateway tools |
| GET | `/v2/action-gateway/tools/health` | Get action gateway tools health |
| GET | `/v2/action-gateway/tools/health/providers` | Get action gateway tools health providers |
| GET | `/v2/action-gateway/tools/health/tools/{tool_slug}` | Get action gateway tools health tools by tool slug |
| GET | `/v2/action-gateway/tools/providers` | Get action gateway tools providers |
| GET | `/v2/action-gateway/tools/providers/search` | Get action gateway tools providers search |
| GET | `/v2/action-gateway/tools/search` | Get action gateway tools search |
| GET | `/v2/action-gateway/tools/toolkits` | Get action gateway tools toolkits |
| GET | `/v2/action-gateway/users` | Get action gateway users |
| GET | `/v2/action-gateway/users/{user_id}` | Get action gateway users by user id |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/digital-ocean/openapi/digital-ocean-action-gateway-api-openapi.yml
- **Documentation** — https://docs.digitalocean.com/reference/api/api-reference/
- **SourceCode** — https://github.com/digitalocean/openapi

## Other Digital Ocean APIs (12)

- [Digital Ocean Account API](https://apis.io/apis/digital-ocean/digital-ocean-account-api/)
- [Digital Ocean Actions API](https://apis.io/apis/digital-ocean/digital-ocean-actions-api/)
- [Digital Ocean Apps API](https://apis.io/apis/digital-ocean/digital-ocean-apps-api/)
- [Digital Ocean Billing API](https://apis.io/apis/digital-ocean/digital-ocean-billing-api/)
- [Digital Ocean Certificates API](https://apis.io/apis/digital-ocean/digital-ocean-certificates-api/)
- [Digital Ocean Databases API](https://apis.io/apis/digital-ocean/digital-ocean-databases-api/)
- [Digital Ocean Domains API](https://apis.io/apis/digital-ocean/digital-ocean-domains-api/)
- [Digital Ocean Droplets API](https://apis.io/apis/digital-ocean/digital-ocean-droplets-api/)
- [Digital Ocean Firewalls API](https://apis.io/apis/digital-ocean/digital-ocean-firewalls-api/)
- [Digital Ocean Floating IPs API](https://apis.io/apis/digital-ocean/digital-ocean-floating-ips-api/)
- [Digital Ocean Functions API](https://apis.io/apis/digital-ocean/digital-ocean-functions-api/)
- [Digital Ocean Images API](https://apis.io/apis/digital-ocean/digital-ocean-images-api/)

## Tags

Action Gateway

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/digital-ocean/digital-ocean-action-gateway-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/digital-ocean/.