# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Schedules API
  version: 1.0.0
extends: openapi/datadog-schedules-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: 2
- target: $.paths['/api/v2/downtime'].post
  update:
    x-apievangelist-phrasing:
      intent: Schedule a downtime
      effect: write
      questions:
      - How do I schedule a downtime to silence monitors during a deploy?
      - Can I set up a recurring maintenance window that mutes alerts?
      instructions:
      - text: Schedule a downtime with {downtime}.
        slots:
          downtime: requestBody.data
      - text: Create a maintenance downtime defined as {downtime}.
        slots:
          downtime: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/on-call/schedules/{schedule_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an On-Call schedule
      effect: write
      questions:
      - How do I change the rotation layers of an On-Call schedule?
      - Can I add a new person to an existing on-call rotation?
      instructions:
      - text: Update On-Call schedule {schedule_id} with {schedule}.
        slots:
          schedule_id: path.schedule_id
          schedule: requestBody.data
      - text: Replace the rotation in schedule {schedule_id} with {schedule}.
        slots:
          schedule_id: path.schedule_id
          schedule: requestBody.data
      method: generated
      generated: '2026-10-01'