Harness · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Harness Freeze API

3 actions 3 updates phrasing extends openapi/harness-freeze-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Harness's API. It is a proposal applied on top of the contract, not a document Harness publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 3

$.info

$.paths['/rmg/api/freeze/list'].get

$.paths['/rmg/api/freeze/details/{freeze_identifier}'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Freeze API
  version: 1.0.0
extends: openapi/harness-freeze-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: 2
- target: $.paths['/rmg/api/freeze/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployment freezes active in a time range
      effect: read
      questions:
      - Which deployment freezes are in effect during next week's release window?
      - Can I see active freezes for just one project within a time range?
      instructions:
      - text: List freezes active between {start} and {end}.
        slots:
          start: query.startTime
          end: query.endTime
      - text: Show freezes overlapping {start} to {end} in project {project}.
        slots:
          start: query.startTime
          end: query.endTime
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rmg/api/freeze/details/{freeze_identifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of a deployment freeze
      effect: read
      questions:
      - Which services and environments does a particular deployment freeze cover?
      - What are the full details of one freeze window?
      instructions:
      - text: Get details of freeze {freeze}.
        slots:
          freeze: path.freeze_identifier
      - text: Show the entities covered by freeze {freeze} in project {project}.
        slots:
          freeze: path.freeze_identifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'