API Evangelist conversational phrasing for Context Monitors API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Context Monitors API
  version: 1.0.0
extends: openapi/contextdev-monitors-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 13
- target: $.paths['/monitors'].get
  update:
    x-apievangelist-phrasing:
      intent: List and search my website monitors
      effect: read
      questions:
      - How do I see all the website monitors set up on my Context.dev account?
      - Can I search my monitors by name as I type, or only by exact match?
      - Which of my monitors are paused versus active, and can I filter by tag?
      instructions:
      - text: List all of my website monitors.
      - text: Search my monitors for {q}.
        slots:
          q: query.q
      - text: Show only monitors with status {status} tagged {tag}.
        slots:
          status: query.status
          tag: query.tag
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a website change monitor
      effect: write
      questions:
      - How do I start watching a web page for changes?
      - 'What do I need to define when setting up a new monitor: target, detection method and schedule?'
      - Does a newly created monitor take a baseline snapshot right away?
      instructions:
      - text: Create a new monitor called {name} that watches {target} on schedule {schedule}.
        slots:
          name: requestBody.name
          target: requestBody.target
          schedule: requestBody.schedule
      - text: Set up a monitor named {name} on {target} using change detection {change_detection} and notify webhook {webhook}.
        slots:
          name: requestBody.name
          target: requestBody.target
          change_detection: requestBody.change_detection
          webhook: requestBody.webhook
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/{monitor_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of one monitor
      effect: read
      questions:
      - Where can I see the full configuration of a single monitor?
      - What schedule and target is one particular monitor currently using?
      instructions:
      - text: Show me the details of monitor {monitor_id}.
        slots:
          monitor_id: path.monitor_id
      - text: Fetch the configuration for monitor {monitor_id}.
        slots:
          monitor_id: path.monitor_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/{monitor_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a monitor
      effect: destructive
      questions:
      - How do I permanently remove a monitor I no longer need?
      - Can I delete a website monitor instead of just pausing it?
      instructions:
      - text: Delete monitor {monitor_id}.
        slots:
          monitor_id: path.monitor_id
      - text: Remove monitor {monitor_id} from my account for good.
        slots:
          monitor_id: path.monitor_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/{monitor_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing monitor's settings
      effect: write
      questions:
      - Can I pause an existing monitor or rename it without recreating it?
      - Does changing the target of an existing monitor reset its baseline?
      - Is it possible to change how often an existing monitor checks the page?
      instructions:
      - text: Rename monitor {monitor_id} to {name}.
        slots:
          monitor_id: path.monitor_id
          name: requestBody.name
      - text: Set the status of existing monitor {monitor_id} to {status}.
        slots:
          monitor_id: path.monitor_id
          status: requestBody.status
      - text: Change the schedule of existing monitor {monitor_id} to {schedule}.
        slots:
          monitor_id: path.monitor_id
          schedule: requestBody.schedule
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/{monitor_id}/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List the run history of one monitor
      effect: read
      questions:
      - When did a specific monitor last run, and did it succeed?
      - Can I see only the failed runs for one monitor?
      instructions:
      - text: Show the run history for monitor {monitor_id}.
        slots:
          monitor_id: path.monitor_id
      - text: List runs of monitor {monitor_id} with status {status}.
        slots:
          monitor_id: path.monitor_id
          status: query.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/{monitor_id}/changes'].get
  update:
    x-apievangelist-phrasing:
      intent: List changes detected by one monitor
      effect: read
      questions:
      - What changes has a particular monitor picked up on its page?
      - Can I see the changes one monitor detected within a date range?
      instructions:
      - text: Show the changes detected by monitor {monitor_id}.
        slots:
          monitor_id: path.monitor_id
      - text: List changes from monitor {monitor_id} between {since} and {until}.
        slots:
          monitor_id: path.monitor_id
          since: query.since
          until: query.until
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List monitor runs across my whole account
      effect: read
      questions:
      - Is there one feed of runs across every monitor on my account?
      - Which monitor runs failed anywhere in my account recently?
      instructions:
      - text: Show the latest runs across all my monitors.
      - text: List account-wide monitor runs with status {status}.
        slots:
          status: query.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/credit-usage'].get
  update:
    x-apievangelist-phrasing:
      intent: See credits spent per monitor
      effect: read
      questions:
      - Which of my monitors are using the most credits?
      - How many credits did each monitor consume over a given period?
      instructions:
      - text: Break down my credit spend by monitor.
      - text: Show credits charged per monitor from {since} to {until}.
        slots:
          since: query.since
          until: query.until
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/limits'].get
  update:
    x-apievangelist-phrasing:
      intent: Check my monitor count against the plan limit
      effect: read
      questions:
      - How many monitors am I allowed to have on my plan?
      - Am I close to the maximum number of monitors my account allows?
      instructions:
      - text: Check how many monitors I have and my maximum allowed.
      - text: Tell me how much monitor capacity I have left.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/changes'].get
  update:
    x-apievangelist-phrasing:
      intent: List detected changes across all monitors
      effect: read
      questions:
      - How do I get one feed of every change detected across all my monitors?
      - Can I filter the account-wide change feed by tag or detection type?
      - What changed on any of the sites I watch since yesterday?
      instructions:
      - text: Show all changes detected across my monitors since {since}.
        slots:
          since: query.since
      - text: List account-wide changes tagged {tag}.
        slots:
          tag: query.tag
      - text: Show changes across all monitors with change detection type {change_detection_type}.
        slots:
          change_detection_type: query.change_detection_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/changes/{change_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of one detected change
      effect: read
      questions:
      - Where can I see exactly what was different in a single detected change?
      - Can I look up one change record by its ID?
      instructions:
      - text: Show me the details of change {change_id}.
        slots:
          change_id: path.change_id
      - text: Open detected change {change_id}.
        slots:
          change_id: path.change_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/monitors/{monitor_id}/run'].post
  update:
    x-apievangelist-phrasing:
      intent: Trigger a monitor run immediately
      effect: write
      questions:
      - Can I force a monitor to check its page right now instead of waiting for its schedule?
      - Is an on-demand monitor run processed instantly or queued?
      instructions:
      - text: Run monitor {monitor_id} now.
        slots:
          monitor_id: path.monitor_id
      - text: Trigger an immediate off-schedule check for monitor {monitor_id}.
        slots:
          monitor_id: path.monitor_id
      method: generated
      generated: '2026-10-01'