Digital Ocean · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for DigitalOcean Uptime API

12 actions 12 updates phrasing extends openapi/digital-ocean-uptime-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 12

$.info
$.paths['/v2/uptime/checks'].get
$.paths['/v2/uptime/checks'].post
$.paths['/v2/uptime/checks/{check_id}'].get
$.paths['/v2/uptime/checks/{check_id}'].put
$.paths['/v2/uptime/checks/{check_id}'].delete
$.paths['/v2/uptime/checks/{check_id}/state'].get
$.paths['/v2/uptime/checks/{check_id}/alerts'].get
$.paths['/v2/uptime/checks/{check_id}/alerts'].post
$.paths['/v2/uptime/checks/{check_id}/alerts/{alert_id}'].get
$.paths['/v2/uptime/checks/{check_id}/alerts/{alert_id}'].put
$.paths['/v2/uptime/checks/{check_id}/alerts/{alert_id}'].delete

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 Uptime API
  version: 1.0.0
extends: openapi/digital-ocean-uptime-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: 11
- target: $.paths['/v2/uptime/checks'].get
  update:
    x-apievangelist-phrasing:
      intent: List uptime checks
      effect: read
      questions:
      - Which uptime checks are monitoring my endpoints?
      - Can I see all uptime checks in one list?
      instructions:
      - text: List all uptime checks.
      - text: Show every endpoint I'm monitoring with uptime checks.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an uptime check
      effect: write
      questions:
      - How do I start monitoring a URL with uptime checks?
      - Can I add a new uptime check for a new endpoint?
      instructions:
      - text: Create a new uptime check.
      - text: Add an uptime check for a new endpoint.
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks/{check_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an uptime check
      effect: read
      questions:
      - What URL and interval does a specific uptime check use?
      - Can I view one uptime check by its ID?
      instructions:
      - text: Show uptime check {check_id}.
        slots:
          check_id: path.check_id
      - text: Get the configuration of uptime check {check_id}.
        slots:
          check_id: path.check_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks/{check_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an uptime check
      effect: write
      questions:
      - How do I change the URL or interval of an existing uptime check?
      - Can I overwrite an uptime check entirely?
      instructions:
      - text: Replace uptime check {check_id}.
        slots:
          check_id: path.check_id
      - text: Overwrite the configuration of uptime check {check_id}.
        slots:
          check_id: path.check_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks/{check_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an uptime check
      effect: destructive
      questions:
      - How do I stop monitoring an endpoint by removing its uptime check?
      - Can I delete an uptime check I no longer need?
      instructions:
      - text: Delete uptime check {check_id}.
        slots:
          check_id: path.check_id
      - text: Remove uptime check {check_id} so it stops monitoring.
        slots:
          check_id: path.check_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks/{check_id}/state'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an uptime check's state
      effect: read
      questions:
      - Is my uptime check currently up or down?
      - What is the current state of an uptime check?
      instructions:
      - text: Show the state of uptime check {check_id}.
        slots:
          check_id: path.check_id
      - text: Tell me whether uptime check {check_id} is up or down.
        slots:
          check_id: path.check_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks/{check_id}/alerts'].get
  update:
    x-apievangelist-phrasing:
      intent: List alerts on an uptime check
      effect: read
      questions:
      - Which alerts are configured on a given uptime check?
      - Can I see all alert rules for one uptime check?
      instructions:
      - text: List the alerts on uptime check {check_id}.
        slots:
          check_id: path.check_id
      - text: Show the alert rules for uptime check {check_id}.
        slots:
          check_id: path.check_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks/{check_id}/alerts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an alert on an uptime check
      effect: write
      questions:
      - How do I add a new alert rule to an uptime check?
      - Can I create an alert on an existing uptime check?
      instructions:
      - text: Create an alert on uptime check {check_id}.
        slots:
          check_id: path.check_id
      - text: Add a new alert rule to uptime check {check_id}.
        slots:
          check_id: path.check_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks/{check_id}/alerts/{alert_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an alert on an uptime check
      effect: read
      questions:
      - What does a specific alert on an uptime check do?
      - Can I view one alert rule by its ID?
      instructions:
      - text: Show alert {alert_id} on uptime check {check_id}.
        slots:
          alert_id: path.alert_id
          check_id: path.check_id
      - text: Get the configuration of alert {alert_id} for uptime check {check_id}.
        slots:
          alert_id: path.alert_id
          check_id: path.check_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks/{check_id}/alerts/{alert_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an alert on an uptime check
      effect: write
      questions:
      - How do I change an existing alert rule on an uptime check?
      - Can I overwrite an alert on an uptime check entirely?
      instructions:
      - text: Replace alert {alert_id} on uptime check {check_id}.
        slots:
          alert_id: path.alert_id
          check_id: path.check_id
      - text: Overwrite the alert rule {alert_id} for uptime check {check_id}.
        slots:
          alert_id: path.alert_id
          check_id: path.check_id
      method: generated
      generated: '2026-11-18'
- target: $.paths['/v2/uptime/checks/{check_id}/alerts/{alert_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an alert on an uptime check
      effect: destructive
      questions:
      - How do I remove an alert rule from an uptime check?
      - Can I delete an alert on an uptime check?
      instructions:
      - text: Delete alert {alert_id} from uptime check {check_id}.
        slots:
          alert_id: path.alert_id
          check_id: path.check_id
      - text: Remove alert rule {alert_id} on uptime check {check_id}.
        slots:
          alert_id: path.alert_id
          check_id: path.check_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-uptime-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.