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.
View Overlay File View on GitHub Overlay Specification

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

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 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.
All 92 tools →

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.