Digital Ocean · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for DigitalOcean Insights API
29 actions
29 updates
phrasing
extends
openapi/digital-ocean-insights-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 29 · first 16 shown; the file carries all of them
$.info
$.paths['/v2/insights/alert-instances'].get
$.paths['/v2/insights/alert-instances/{id}'].get
$.paths['/v2/insights/alert-rules'].get
$.paths['/v2/insights/alert-rules'].post
$.paths['/v2/insights/alert-rules/{id}'].get
$.paths['/v2/insights/alert-rules/{id}'].put
$.paths['/v2/insights/alert-rules/{id}'].delete
$.paths['/v2/insights/notification-channels'].get
$.paths['/v2/insights/notification-channels'].post
$.paths['/v2/insights/notification-channels/{id}'].get
$.paths['/v2/insights/notification-channels/{id}'].put
$.paths['/v2/insights/notification-channels/{id}'].delete
$.paths['/v2/insights/query/{region}/prom/api/v1/query'].get
$.paths['/v2/insights/query/{region}/prom/api/v1/query'].post
$.paths['/v2/insights/query/{region}/prom/api/v1/query_range'].get
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 Insights API
version: 1.0.0
extends: openapi/digital-ocean-insights-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: 28
- target: $.paths['/v2/insights/alert-instances'].get
update:
x-apievangelist-phrasing:
intent: List alert instances
effect: read
questions:
- Which alert rules fired in my account recently?
- Can I see every alert instance across all regions?
instructions:
- text: List all alert instances.
- text: Show alert instances for the last 24 hours.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/alert-instances/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get one alert instance
effect: read
questions:
- What happened when a specific alert fired?
- Can I look up a single alert instance by ID?
instructions:
- text: Get alert instance {id}.
slots:
id: path.id
- text: Show the details of alert instance {id}.
slots:
id: path.id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/alert-rules'].get
update:
x-apievangelist-phrasing:
intent: List alert rules
effect: read
questions:
- What alert rules are set up for my account?
- Can I see all the alert rules in one place?
instructions:
- text: List all alert rules.
- text: Show every alert rule configured.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/alert-rules'].post
update:
x-apievangelist-phrasing:
intent: Create an alert rule
effect: write
questions:
- How do I create a new alert rule that watches CPU usage?
- Can I add an alert rule for a specific droplet?
instructions:
- text: Create a new alert rule.
- text: Add an alert rule that fires when a metric crosses a threshold.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/alert-rules/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get one alert rule
effect: read
questions:
- What does a particular alert rule check for?
- Can I view a single alert rule by ID?
instructions:
- text: Get alert rule {id}.
slots:
id: path.id
- text: Show the condition and targets of alert rule {id}.
slots:
id: path.id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/alert-rules/{id}'].put
update:
x-apievangelist-phrasing:
intent: Replace an alert rule
effect: write
questions:
- How do I change the condition of an existing alert rule?
- Can I overwrite an alert rule entirely?
instructions:
- text: Replace alert rule {id}.
slots:
id: path.id
- text: Overwrite the condition of alert rule {id}.
slots:
id: path.id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/alert-rules/{id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete an alert rule
effect: destructive
questions:
- How do I remove an alert rule I no longer need?
- Can I delete an alert rule by ID?
instructions:
- text: Delete alert rule {id}.
slots:
id: path.id
- text: Remove the alert rule {id}.
slots:
id: path.id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/notification-channels'].get
update:
x-apievangelist-phrasing:
intent: List notification channels
effect: read
questions:
- Which notification channels are set up for alert events?
- Can I see all my alert notification channels?
instructions:
- text: List all notification channels.
- text: Show every alert notification channel.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/notification-channels'].post
update:
x-apievangelist-phrasing:
intent: Create a notification channel
effect: write
questions:
- How do I create a notification channel for alert events?
- Can I add a new email notification channel?
instructions:
- text: Create a new notification channel.
- text: Add a notification channel for alert events.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/notification-channels/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get one notification channel
effect: read
questions:
- What does a particular notification channel deliver to?
- Can I view a single notification channel by ID?
instructions:
- text: Get notification channel {id}.
slots:
id: path.id
- text: Show the details of notification channel {id}.
slots:
id: path.id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/notification-channels/{id}'].put
update:
x-apievangelist-phrasing:
intent: Replace a notification channel
effect: write
questions:
- How do I change the targets of an existing notification channel?
- Can I overwrite a notification channel entirely?
instructions:
- text: Replace notification channel {id}.
slots:
id: path.id
- text: Overwrite the targets of notification channel {id}.
slots:
id: path.id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/notification-channels/{id}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a notification channel
effect: destructive
questions:
- How do I remove a notification channel?
- Can I delete a notification channel by ID?
instructions:
- text: Delete notification channel {id}.
slots:
id: path.id
- text: Remove the notification channel {id}.
slots:
id: path.id
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/prom/api/v1/query'].get
update:
x-apievangelist-phrasing:
intent: Query metrics in a region
effect: read
questions:
- How do I run a PromQL query against metrics in a single region?
- Can I get a single metric value from one region?
instructions:
- text: Run a PromQL query in region {region}.
slots:
region: path.region
- text: Get the current value of a metric in {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/prom/api/v1/query'].post
update:
x-apievangelist-phrasing:
intent: Run a PromQL query in a region
effect: read
questions:
- Can I send a PromQL query to a specific region?
- How do I evaluate a PromQL expression for one region?
instructions:
- text: Post a PromQL query to region {region}.
slots:
region: path.region
- text: Evaluate this PromQL expression in {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/prom/api/v1/query_range'].get
update:
x-apievangelist-phrasing:
intent: Query metrics over a time range in a region
effect: read
questions:
- How do I get a time series of a metric in one region?
- Can I fetch a range of metric values for a region?
instructions:
- text: Get a time range of metrics in region {region}.
slots:
region: path.region
- text: Fetch metric values for {region} over a time range.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/prom/api/v1/query_range'].post
update:
x-apievangelist-phrasing:
intent: Run a range query over a region's metrics
effect: read
questions:
- How do I fetch Prometheus metric values over a time range for a region?
- Can I chart a timeseries from a region's insights data?
instructions:
- text: Run a range query over the metrics in {region}.
slots:
region: path.region
- text: Fetch a timeseries from insights for {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/prom/api/v1/labels'].get
update:
x-apievangelist-phrasing:
intent: List metric labels in a region
effect: read
questions:
- Which label names are available for metrics in a region?
- Can I see the label keys for one region?
instructions:
- text: List metric labels in region {region}.
slots:
region: path.region
- text: Show the label names available in {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/prom/api/v1/labels'].post
update:
x-apievangelist-phrasing:
intent: List labels available for a region
effect: read
questions:
- Which labels are available for querying metrics in a region?
- What label values can I use to filter a region's Prometheus queries?
instructions:
- text: List labels available for {region}.
slots:
region: path.region
- text: Show the label names I can query in {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/prom/api/v1/label/{name}/values'].get
update:
x-apievangelist-phrasing:
intent: Get label values in a region
effect: read
questions:
- What values does a metric label have in a region?
- Can I see all the values of one label in a region?
instructions:
- text: Get values of label {name} in region {region}.
slots:
name: path.name
region: path.region
- text: Show the {name} label values available in {region}.
slots:
name: path.name
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/prom/api/v1/series'].get
update:
x-apievangelist-phrasing:
intent: Find metric series in a region
effect: read
questions:
- How do I find which metric series match a label filter in a region?
- Can I list the series of a metric in one region?
instructions:
- text: Find metric series in region {region}.
slots:
region: path.region
- text: List the series matching a label filter in {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/prom/api/v1/series'].post
update:
x-apievangelist-phrasing:
intent: Query Prometheus series for a region
effect: read
questions:
- How do I get the Prometheus time series for a region?
- Can I list the metric series available in one region?
instructions:
- text: Query Prometheus series in {region}.
slots:
region: path.region
- text: List the time series for {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/logs/search'].post
update:
x-apievangelist-phrasing:
intent: Search logs for a region
effect: read
questions:
- How do I search logs for a region?
- Can I find log entries in one region?
instructions:
- text: Search logs in {region}.
slots:
region: path.region
- text: Find log entries for {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/traces/search'].post
update:
x-apievangelist-phrasing:
intent: Search traces for a region
effect: read
questions:
- How do I search traces for a region?
- Can I find trace spans in one region?
instructions:
- text: Search traces in {region}.
slots:
region: path.region
- text: Find trace spans for {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/traces/{trace_id}'].get
update:
x-apievangelist-phrasing:
intent: Get a trace in a region
effect: read
questions:
- How do I fetch a single trace in a region?
- Can I look up one trace by its ID?
instructions:
- text: Get trace {trace_id} in {region}.
slots:
trace_id: path.trace_id
region: path.region
- text: Show trace {trace_id} for {region}.
slots:
trace_id: path.trace_id
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/query/{region}/spans/search'].post
update:
x-apievangelist-phrasing:
intent: Search spans for a region
effect: read
questions:
- How do I search spans for a region?
- Can I find span entries in one region?
instructions:
- text: Search spans in {region}.
slots:
region: path.region
- text: Find span entries for {region}.
slots:
region: path.region
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/resources'].get
update:
x-apievangelist-phrasing:
intent: List resources with insights enabled
effect: read
questions:
- Which resources have metrics, logs or traces enabled?
- Can I list all resources with insights signals?
instructions:
- text: List resources with insights enabled.
- text: Show every resource that has metrics, logs or traces turned on.
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/resources/{resource_urn}'].get
update:
x-apievangelist-phrasing:
intent: Get insights signals for a resource
effect: read
questions:
- How do I see the metrics, logs and traces signals for one resource?
- Can I look up a resource by its URN?
instructions:
- text: Get insights signals for resource {resource_urn}.
slots:
resource_urn: path.resource_urn
- text: Show metrics, logs and traces for {resource_urn}.
slots:
resource_urn: path.resource_urn
method: generated
generated: '2026-11-18'
- target: $.paths['/v2/insights/resources/{resource_urn}/signals'].put
update:
x-apievangelist-phrasing:
intent: Replace a resource's insights signals
effect: write
questions:
- How do I turn metrics, logs or traces on for a resource?
- Can I replace the signals enabled on one resource?
instructions:
- text: Replace the insights signals on {resource_urn}.
slots:
resource_urn: path.resource_urn
- text: Enable metrics, logs and traces on {resource_urn}.
slots:
resource_urn: path.resource_urn
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-insights-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.