# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness DORA API
  version: 1.0.0
extends: openapi/harness-dora-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: 4
- target: $.paths['/v1/dora/lead-time'].post
  update:
    x-apievangelist-phrasing:
      intent: Get DORA lead time for changes
      effect: read
      questions:
      - How long does it take our changes to get from commit to production?
      - Can I see lead time for changes per collection or team?
      instructions:
      - text: Get lead time data for collections {ous}.
        slots:
          ous: requestBody.ou_ids
      - text: Show lead time for changes across {across}.
        slots:
          across: requestBody.across
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dora/deployment_frequency'].post
  update:
    x-apievangelist-phrasing:
      intent: Get DORA deployment frequency
      effect: read
      questions:
      - How often are we deploying to production?
      - Can I filter deployment frequency for specific collections?
      instructions:
      - text: Get deployment frequency for collections {ous}.
        slots:
          ous: requestBody.ou_ids
      - text: Show how often we deploy using filter {filter}.
        slots:
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dora/change_failure_rate'].post
  update:
    x-apievangelist-phrasing:
      intent: Get DORA change failure rate
      effect: read
      questions:
      - What percentage of our deployments cause failures?
      - Can I get the change failure rate for one team's collection?
      instructions:
      - text: Get the change failure rate for collections {ous}.
        slots:
          ous: requestBody.ou_ids
      - text: Show failed-change percentage with filter {filter}.
        slots:
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/dora/mean-time'].post
  update:
    x-apievangelist-phrasing:
      intent: Get DORA mean time to restore
      effect: read
      questions:
      - How quickly do we recover from incidents on average?
      - Can I get MTTR for a specific dashboard widget?
      instructions:
      - text: Get mean time to restore for collections {ous}.
        slots:
          ous: requestBody.ou_ids
      - text: Show MTTR for widget {widget}.
        slots:
          widget: requestBody.widget_id
      method: generated
      generated: '2026-09-26'