Harness · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Harness Network Maps API

8 actions 8 updates phrasing extends openapi/harness-network-maps-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 8

$.info
$.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps'].post
$.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}'].get
$.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}'].delete
$.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}/canretry'].get
$.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}/retry'].post
$.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}/targetservices'].get
$.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}/targetservices/{targetserviceid}'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Network Maps API
  version: 1.0.0
extends: openapi/harness-network-maps-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: 7
- target: $.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps'].post
  update:
    x-apievangelist-phrasing:
      intent: List network maps for chaos targeting
      effect: read
      questions:
      - Which application network maps are available to target with chaos experiments?
      - Can I filter network maps by environment or chaos infrastructure?
      instructions:
      - text: List network maps in project {projectIdentifier} of org {organizationIdentifier}, page {page} with {limit} per page.
        slots:
          projectIdentifier: query.projectIdentifier
          organizationIdentifier: query.organizationIdentifier
          page: query.page
          limit: query.limit
      - text: Show network maps for environment {environmentIdentifier} on infrastructure {infraId} named like {search}.
        slots:
          environmentIdentifier: query.environmentIdentifier
          infraId: query.infraId
          search: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a network map with chaos context
      effect: read
      questions:
      - What services and chaos details are in a particular application network map?
      - How do I look up one network map by its id for a chaos infrastructure?
      instructions:
      - text: Get network map {applicationmapid} in environment {environmentIdentifier} on infrastructure {infraId}.
        slots:
          applicationmapid: path.applicationmapid
          environmentIdentifier: query.environmentIdentifier
          infraId: query.infraId
      - text: Show the chaos context for application map {applicationmapid}.
        slots:
          applicationmapid: path.applicationmapid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application network map
      effect: destructive
      questions:
      - How do I delete an application network map I no longer target?
      - Can I remove a network map from a chaos infrastructure?
      instructions:
      - text: Delete network map {applicationmapid} from infrastructure {infraId} in environment {environmentIdentifier}.
        slots:
          applicationmapid: path.applicationmapid
          infraId: query.infraId
          environmentIdentifier: query.environmentIdentifier
      - text: Remove application map {applicationmapid} and its chaos context.
        slots:
          applicationmapid: path.applicationmapid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}/canretry'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if experiment creation can be retried
      effect: read
      questions:
      - Can chaos experiment creation be retried for a network map where it failed?
      - Is a retry of experiment generation allowed for this application map?
      instructions:
      - text: Check whether experiment creation can be retried for network map {applicationmapid}.
        slots:
          applicationmapid: path.applicationmapid
      - text: Tell me if application map {applicationmapid} on {infraId} is eligible for an experiment-creation retry.
        slots:
          applicationmapid: path.applicationmapid
          infraId: query.infraId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}/retry'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry chaos experiment creation for a network map
      effect: write
      questions:
      - How do I rerun chaos experiment creation for a network map after it failed?
      - Can I choose a mode when retrying experiment generation?
      instructions:
      - text: Retry chaos experiment creation for network map {applicationmapid}.
        slots:
          applicationmapid: path.applicationmapid
      - text: Regenerate experiments for application map {applicationmapid} using mode {mode}.
        slots:
          applicationmapid: path.applicationmapid
          mode: requestBody.mode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}/targetservices'].get
  update:
    x-apievangelist-phrasing:
      intent: List discovered services in a network map
      effect: read
      questions:
      - Which discovered services are part of a given network map?
      - Can I search the target services inside one application map?
      instructions:
      - text: List the target services in network map {applicationmapid}, page {page} with {limit} per page.
        slots:
          applicationmapid: path.applicationmapid
          page: query.page
          limit: query.limit
      - text: Find services named like {search} in application map {applicationmapid}.
        slots:
          search: query.search
          applicationmapid: path.applicationmapid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/applicationmaps/{applicationmapid}/targetservices/{targetserviceid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one discovered service in a network map
      effect: read
      questions:
      - What chaos details are recorded for a single discovered service in my network map?
      - How do I inspect one target service by id within an application map?
      instructions:
      - text: Get target service {targetserviceid} in network map {applicationmapid}.
        slots:
          targetserviceid: path.targetserviceid
          applicationmapid: path.applicationmapid
      - text: Show the chaos context for service {targetserviceid} of application map {applicationmapid}.
        slots:
          targetserviceid: path.targetserviceid
          applicationmapid: path.applicationmapid
      method: generated
      generated: '2026-09-26'