API Evangelist conversational phrasing for Algolia Monitoring API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Algolia Monitoring API
  version: 1.0.0
extends: openapi/algolia-monitoring-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 14
- target: $.paths['/{path}'].get
  update:
    x-apievangelist-phrasing:
      intent: Send a raw GET request to the Monitoring API
      effect: read
      questions:
      - Can I read a Monitoring endpoint that the client library doesn't wrap?
      - Is there a generic way to GET any Monitoring API path with custom query parameters?
      instructions:
      - text: Send a raw GET request to Monitoring API path {path}.
        slots:
          path: path.path
      - text: Fetch Monitoring path {path} with query parameters {parameters}.
        slots:
          path: path.path
          parameters: query.parameters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{path}'].put
  update:
    x-apievangelist-phrasing:
      intent: Send a raw PUT request to the Monitoring API
      effect: write
      questions:
      - Can I send a custom PUT to a Monitoring path that has no dedicated method?
      - Is there a passthrough for PUT calls on an arbitrary Monitoring endpoint?
      instructions:
      - text: Send a raw PUT request to Monitoring API path {path}.
        slots:
          path: path.path
      - text: PUT to Monitoring path {path} with query parameters {parameters}.
        slots:
          path: path.path
          parameters: query.parameters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{path}'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a raw POST request to the Monitoring API
      effect: write
      questions:
      - Can I POST to a Monitoring endpoint the SDK doesn't expose as a method?
      - What's the generic escape hatch for posting to any Monitoring API path?
      instructions:
      - text: Send a raw POST request to Monitoring API path {path}.
        slots:
          path: path.path
      - text: POST to Monitoring path {path} with query parameters {parameters}.
        slots:
          path: path.path
          parameters: query.parameters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{path}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Send a raw DELETE request to the Monitoring API
      effect: destructive
      questions:
      - Can I issue a DELETE against an arbitrary Monitoring API path?
      - Is there a generic delete call for Monitoring endpoints without a dedicated method?
      instructions:
      - text: Send a raw DELETE request to Monitoring API path {path}.
        slots:
          path: path.path
      - text: DELETE Monitoring path {path} with query parameters {parameters}.
        slots:
          path: path.path
          parameters: query.parameters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/1/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of all Algolia clusters
      effect: read
      questions:
      - Is Algolia up right now across all clusters?
      - Which clusters and instances are currently reporting a degraded status?
      instructions:
      - text: Show the status of every Algolia cluster.
      - text: Tell me whether any cluster anywhere is down right now.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/1/status/{clusters}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of specific clusters
      effect: read
      questions:
      - Is the cluster my application runs on operational?
      - How do I check the status of just a couple of named clusters?
      instructions:
      - text: Check the status of clusters {clusters}.
        slots:
          clusters: path.clusters
      - text: Confirm whether cluster {clusters} is operational right now.
        slots:
          clusters: path.clusters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/1/incidents'].get
  update:
    x-apievangelist-phrasing:
      intent: List known incidents across all clusters
      effect: read
      questions:
      - Are there any known incidents affecting Algolia clusters?
      - What incidents has the platform reported recently across every cluster?
      instructions:
      - text: List all known incidents across every cluster.
      - text: Show me every open or recent platform-wide incident.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/1/incidents/{clusters}'].get
  update:
    x-apievangelist-phrasing:
      intent: List incidents for specific clusters
      effect: read
      questions:
      - Has my cluster had any incidents lately?
      - Which incidents were reported against a particular set of clusters?
      instructions:
      - text: List incidents reported for clusters {clusters}.
        slots:
          clusters: path.clusters
      - text: Show any incidents logged against cluster {clusters}.
        slots:
          clusters: path.clusters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/1/inventory/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List the servers behind my clusters
      effect: read
      questions:
      - Which servers is my Algolia application assigned to?
      - What servers make up the clusters in the inventory?
      instructions:
      - text: List the servers assigned to my application's clusters.
      - text: Show the server inventory for my clusters.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/1/latency/{clusters}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get average search latency for clusters
      effect: read
      questions:
      - How fast are search requests on my cluster on average?
      - What's the current average search latency for a given cluster?
      instructions:
      - text: Show average search latency for clusters {clusters}.
        slots:
          clusters: path.clusters
      - text: Report how long searches take on cluster {clusters} right now.
        slots:
          clusters: path.clusters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/1/indexing/{clusters}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get indexing latency for clusters
      effect: read
      questions:
      - How long does indexing currently take on my cluster?
      - Is indexing on a specific cluster lagging behind?
      instructions:
      - text: Show indexing latency metrics for clusters {clusters}.
        slots:
          clusters: path.clusters
      - text: Check whether indexing is slow on cluster {clusters}.
        slots:
          clusters: path.clusters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/1/reachability/{clusters}/probes'].get
  update:
    x-apievangelist-phrasing:
      intent: Test whether clusters are reachable
      effect: read
      questions:
      - Can Algolia's probes reach my cluster?
      - How do I test network reachability for a set of clusters?
      instructions:
      - text: Run reachability probes against clusters {clusters}.
        slots:
          clusters: path.clusters
      - text: Tell me if cluster {clusters} is reachable from the probes.
        slots:
          clusters: path.clusters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/1/infrastructure/{metric}/period/{period}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get infrastructure metrics over a time window
      effect: read
      questions:
      - How do I pull every infrastructure metric for my Algolia servers aggregated over the last day?
      - What infrastructure metrics can I see aggregated over a chosen period on Premium or Elevate?
      instructions:
      - text: Get infrastructure metric {metric} over period {period}.
        slots:
          metric: path.metric
          period: path.period
      - text: Report {metric} for my servers aggregated over the last {period}.
        slots:
          metric: path.metric
          period: path.period
      method: generated
      generated: '2026-09-26'
- target: $.paths['/setClientApiKey'].get
  update:
    x-apievangelist-phrasing:
      intent: Switch the API key the Monitoring client uses
      effect: write
      questions:
      - Can I change which API key my Monitoring client authenticates with?
      - How do I rotate the key an existing Monitoring client sends?
      instructions:
      - text: Switch the Monitoring client to authenticate with API key {apiKey}.
        slots:
          apiKey: query.apiKey
      - text: Use {apiKey} for all further Monitoring API requests.
        slots:
          apiKey: query.apiKey
      method: generated
      generated: '2026-09-26'