# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Chaos Infrastructure API
  version: 1.0.0
extends: openapi/harness-chaos-infrastructure-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: 32
- target: $.paths['/gateway/chaos/manager/api/rest/imageRegistry'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the chaos image registry settings
      effect: read
      questions:
      - Which container image registry does Harness Chaos Engineering pull its chaos images from?
      - Can I see the image registry configured for my chaos experiments?
      instructions:
      - text: Show me the image registry configured for chaos engineering.
      - text: Look up where my chaos infrastructure pulls its images from.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a legacy Kubernetes chaos infrastructure
      effect: write
      questions:
      - How do I register a legacy Kubernetes chaos infrastructure in a project?
      - Can I install a legacy chaos infra into an existing namespace with its own service account?
      - Is it possible to turn on auto-upgrade when registering a legacy Kubernetes chaos infra?
      instructions:
      - text: Register a legacy Kubernetes chaos infra named {name} in project {project} of org {org}.
        slots:
          name: requestBody.name
          project: query.projectIdentifier
          org: query.organizationIdentifier
      - text: Register legacy Kubernetes chaos infra {name} in namespace {namespace} for environment {environment}.
        slots:
          name: requestBody.name
          namespace: requestBody.infraNamespace
          environment: requestBody.environmentID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra/helm-command/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Helm install command for a legacy chaos infra
      effect: read
      questions:
      - What Helm command do I run to install my legacy Kubernetes chaos infrastructure?
      - Can I get a Helm command instead of a manifest for a legacy chaos infra?
      instructions:
      - text: Get the Helm install command for legacy chaos infra {infra_id}.
        slots:
          infra_id: path.id
      - text: Give me the Helm command for legacy Kubernetes chaos infra {infra_id} in project {project}.
        slots:
          infra_id: path.id
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra/manifest/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the manifest for a legacy chaos infra
      effect: read
      questions:
      - Where do I get the Kubernetes YAML manifest to apply for a legacy chaos infrastructure?
      - Can I download the install manifest for a legacy chaos infra I already registered?
      instructions:
      - text: Download the Kubernetes manifest for legacy chaos infra {infra_id}.
        slots:
          infra_id: path.id
      - text: Fetch the install YAML for legacy chaos infra {infra_id} in project {project}.
        slots:
          infra_id: path.id
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get statistics for legacy Kubernetes chaos infras
      effect: read
      questions:
      - How many legacy Kubernetes chaos infrastructures does my project have?
      - Can I see summary stats for the legacy chaos infras in a project?
      instructions:
      - text: Show stats for legacy Kubernetes chaos infras in project {project}.
        slots:
          project: query.projectIdentifier
      - text: Summarize the legacy chaos infrastructure counts for org {org}, project {project}.
        slots:
          org: query.organizationIdentifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra/upgrade/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Upgrade a legacy Kubernetes chaos infrastructure
      effect: write
      questions:
      - How do I upgrade an outdated legacy Kubernetes chaos infrastructure to the latest version?
      - Can I trigger an upgrade of one legacy chaos infra from the API?
      instructions:
      - text: Upgrade legacy Kubernetes chaos infra {infra_id}.
        slots:
          infra_id: path.id
      - text: Bring legacy chaos infra {infra_id} in project {project} up to the current version.
        slots:
          infra_id: path.id
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra/version'].get
  update:
    x-apievangelist-phrasing:
      intent: Get version details for legacy Kubernetes chaos infras
      effect: read
      questions:
      - What versions are available for legacy Kubernetes chaos infrastructure?
      - Which legacy chaos infra version is current, so I know whether to upgrade?
      instructions:
      - text: Show legacy Kubernetes chaos infra version details for project {project}.
        slots:
          project: query.projectIdentifier
      - text: Check the latest supported legacy chaos infra version in org {org}.
        slots:
          org: query.organizationIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a legacy Kubernetes chaos infra
      effect: read
      questions:
      - How can I see the configuration and status of one legacy Kubernetes chaos infra?
      - What namespace and environment is a given legacy chaos infrastructure registered to?
      instructions:
      - text: Get the details of legacy Kubernetes chaos infra {infra_id}.
        slots:
          infra_id: path.id
      - text: Show legacy chaos infra {infra_id} in project {project}.
        slots:
          infra_id: path.id
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a legacy Kubernetes chaos infra
      effect: write
      questions:
      - Can I rename or retag a legacy Kubernetes chaos infrastructure after registering it?
      - How do I move a legacy chaos infra to a different environment?
      instructions:
      - text: Rename legacy Kubernetes chaos infra {infra_id} to {name}.
        slots:
          infra_id: path.id
          name: requestBody.name
      - text: Change the description of legacy chaos infra {infra_id} to {description}.
        slots:
          infra_id: path.id
          description: requestBody.description
      - text: Assign legacy chaos infra {infra_id} to environment {environment}.
        slots:
          infra_id: path.id
          environment: requestBody.environmentID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a legacy Kubernetes chaos infra
      effect: destructive
      questions:
      - How do I remove a legacy Kubernetes chaos infrastructure from my project?
      - Can I force-delete a legacy chaos infra that is no longer reachable?
      instructions:
      - text: Delete legacy Kubernetes chaos infra {infra_id}.
        slots:
          infra_id: path.id
      - text: Force-delete legacy chaos infra {infra_id} with force set to {force}.
        slots:
          infra_id: path.id
          force: query.forceDelete
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infra/health/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check connectivity of a legacy chaos infra
      effect: read
      questions:
      - Is my legacy Kubernetes chaos infrastructure connected and healthy?
      - How can I test whether a legacy chaos infra can still reach Harness?
      instructions:
      - text: Test the connection health of legacy chaos infra {infra_id}.
        slots:
          infra_id: path.id
      - text: Run a health check on legacy Kubernetes chaos infra {infra_id} in project {project}.
        slots:
          infra_id: path.id
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/kubernetes/infras'].post
  update:
    x-apievangelist-phrasing:
      intent: List legacy Kubernetes chaos infras
      effect: read
      questions:
      - Which legacy Kubernetes chaos infrastructures are registered in my project?
      - Can I filter legacy chaos infras by environment or Kubernetes connector?
      instructions:
      - text: List the legacy Kubernetes chaos infras in project {project}.
        slots:
          project: query.projectIdentifier
      - text: List legacy chaos infras attached to Kubernetes connectors {connectors}.
        slots:
          connectors: requestBody.k8sConnectorIDs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/machine/infra'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a machine chaos infrastructure
      effect: write
      questions:
      - How do I register a Linux or Windows machine as a chaos infrastructure?
      - Can I tag a machine chaos infra and assign it to an environment when I register it?
      instructions:
      - text: Register a {infra_type} machine chaos infra named {name} in project {project}.
        slots:
          infra_type: query.infraType
          name: requestBody.name
          project: query.projectIdentifier
      - text: Register machine chaos infra {name} of type {infra_type} for environment {environment}.
        slots:
          name: requestBody.name
          infra_type: query.infraType
          environment: requestBody.environmentID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/machine/infra/version'].get
  update:
    x-apievangelist-phrasing:
      intent: Get version details for machine chaos infras
      effect: read
      questions:
      - What is the latest agent version for machine chaos infrastructure?
      - Can I check machine chaos infra versions for a specific machine type?
      instructions:
      - text: Show machine chaos infra version details for type {infra_type}.
        slots:
          infra_type: query.infraType
      - text: Check available {infra_type} machine chaos infra versions in project {project}.
        slots:
          infra_type: query.infraType
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/machine/infra/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a machine chaos infra
      effect: read
      questions:
      - How do I look up one machine chaos infrastructure and its current state?
      - What environment and tags does a registered machine chaos infra have?
      instructions:
      - text: Get details of machine chaos infra {infra_id} of type {infra_type}.
        slots:
          infra_id: path.id
          infra_type: query.infraType
      - text: Show machine chaos infra {infra_id} in project {project}.
        slots:
          infra_id: path.id
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/machine/infra/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a machine chaos infra
      effect: write
      questions:
      - Can I rename a machine chaos infrastructure or change its tags?
      - How do I move a machine chaos infra to another environment?
      instructions:
      - text: Rename machine chaos infra {infra_id} to {name}.
        slots:
          infra_id: path.id
          name: requestBody.name
      - text: Move machine chaos infra {infra_id} of type {infra_type} to environment {environment}.
        slots:
          infra_id: path.id
          infra_type: query.infraType
          environment: requestBody.environmentID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/machine/infra/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a machine chaos infra
      effect: destructive
      questions:
      - How do I remove a machine chaos infrastructure I no longer use?
      - Can I force-remove a machine chaos infra whose host is gone?
      instructions:
      - text: Delete machine chaos infra {infra_id} of type {infra_type}.
        slots:
          infra_id: path.id
          infra_type: query.infraType
      - text: Force-delete machine chaos infra {infra_id}, force flag {force}.
        slots:
          infra_id: path.id
          force: query.forceDelete
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/machine/infras'].post
  update:
    x-apievangelist-phrasing:
      intent: List machine chaos infras
      effect: read
      questions:
      - Which machines are registered as chaos infrastructure in my project?
      - Can I search machine chaos infras by name and page through the results?
      instructions:
      - text: List {infra_type} machine chaos infras in project {project}, page {page} of {limit}.
        slots:
          infra_type: query.infraType
          project: query.projectIdentifier
          page: query.page
          limit: query.limit
      - text: Search machine chaos infras of type {infra_type} for {term}.
        slots:
          infra_type: query.infraType
          term: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/usage'].get
  update:
    x-apievangelist-phrasing:
      intent: Get chaos engineering resource usage
      effect: read
      questions:
      - How much of my chaos engineering resource allowance has my account used?
      - Can I see chaos resource usage for the account?
      instructions:
      - text: Show my chaos engineering resource usage.
      - text: Report how many chaos resources the account is consuming.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/harness-infrastructures'].get
  update:
    x-apievangelist-phrasing:
      intent: List Harness infrastructures in an environment
      effect: read
      questions:
      - Which Harness infrastructure definitions exist in a given environment for chaos use?
      - Can I search Harness infrastructures within one environment?
      instructions:
      - text: List Harness infrastructures in environment {environment}, page {page}, {limit} per page.
        slots:
          environment: query.environmentIdentifier
          page: query.page
          limit: query.limit
      - text: Search Harness infrastructures in environment {environment} for {term}.
        slots:
          environment: query.environmentIdentifier
          term: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructure'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a v2 chaos infrastructure
      effect: write
      questions:
      - How do I change the namespace or image registry of an existing v2 chaos infrastructure?
      - Can I turn on AI or autopilot for a v2 chaos infra that is already registered?
      instructions:
      - text: Update v2 chaos infra {identity} to use namespace {namespace}.
        slots:
          identity: requestBody.identity
          namespace: requestBody.infraNamespace
      - text: 'Enable autopilot on v2 chaos infra {identity}: set it to {autopilot}.'
        slots:
          identity: requestBody.identity
          autopilot: requestBody.autopilotEnabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructure'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a new v2 chaos infrastructure
      effect: write
      questions:
      - How do I register a new v2 chaos infrastructure in a Harness environment?
      - Can I link a discovery agent when registering a v2 chaos infra?
      instructions:
      - text: Register a v2 chaos infra {identifier} in environment {environment} in namespace {namespace}.
        slots:
          identifier: requestBody.identifier
          environment: requestBody.environmentID
          namespace: requestBody.infraNamespace
      - text: Register v2 chaos infra {identifier} in project {project} with discovery agent {agent}.
        slots:
          identifier: requestBody.identifier
          project: query.projectIdentifier
          agent: requestBody.discoveryAgentID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructure/yaml'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview the YAML for a v2 chaos infra
      effect: read
      questions:
      - Can I preview the YAML a v2 chaos infrastructure would generate before registering it?
      - What would the v2 chaos infra manifest look like with a proxy and node selector set?
      instructions:
      - text: Preview the v2 chaos infra YAML for namespace {namespace} in environment {environment}.
        slots:
          namespace: requestBody.infraNamespace
          environment: requestBody.environmentID
      - text: Generate a YAML preview for v2 infra {identifier} in project {project}.
        slots:
          identifier: requestBody.identifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructure/{environmentIdentifier}/{identity}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a v2 chaos infrastructure
      effect: destructive
      questions:
      - How do I remove a v2 chaos infrastructure from an environment?
      - Can I delete a v2 chaos infra by its identity?
      instructions:
      - text: Delete v2 chaos infra {identity} from environment {environment}.
        slots:
          identity: path.identity
          environment: path.environmentIdentifier
      - text: Remove v2 infra {identity} in environment {environment} of project {project}.
        slots:
          identity: path.identity
          environment: path.environmentIdentifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructure/{identity}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a v2 chaos infrastructure
      effect: read
      questions:
      - How do I view the configuration of one v2 chaos infrastructure?
      - What namespace and settings does a given v2 chaos infra use?
      instructions:
      - text: Get v2 chaos infra {identity} in environment {environment}.
        slots:
          identity: path.identity
          environment: query.environmentIdentifier
      - text: Show the details of v2 infra {identity} in project {project}.
        slots:
          identity: path.identity
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructure/{identity}/connector'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the connector behind a v2 chaos infra
      effect: read
      questions:
      - Which connector does a v2 chaos infrastructure use?
      - Can I find the Kubernetes connector backing a chaos infra?
      instructions:
      - text: Get the connector for v2 chaos infra {identity} in environment {environment}.
        slots:
          identity: path.identity
          environment: query.environmentIdentifier
      - text: Show which connector backs chaos infra {identity}.
        slots:
          identity: path.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructures'].post
  update:
    x-apievangelist-phrasing:
      intent: List v2 chaos infrastructures
      effect: read
      questions:
      - What v2 chaos infrastructures are registered in my project?
      - Can the v2 infra list also include legacy infrastructures?
      instructions:
      - text: List v2 chaos infras in project {project}, page {page}, {limit} per page.
        slots:
          project: query.projectIdentifier
          page: query.page
          limit: query.limit
      - text: 'List all v2 chaos infras including legacy ones: include legacy {include_legacy}.'
        slots:
          include_legacy: query.includeLegacyInfra
      - text: Search v2 chaos infras in environment {environment} for {term}.
        slots:
          environment: query.environmentIdentifier
          term: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructures/chaos-enabled'].post
  update:
    x-apievangelist-phrasing:
      intent: List v2 infras that have chaos enabled
      effect: read
      questions:
      - Which of my v2 infrastructures actually have chaos enabled?
      - Can I list only chaos-enabled infrastructures in an environment?
      instructions:
      - text: Show page {page} of chaos-enabled infrastructures in project {project}, {limit} at a time.
        slots:
          project: query.projectIdentifier
          page: query.page
          limit: query.limit
      - text: Show only chaos-enabled infrastructures in environment {environment}.
        slots:
          environment: query.environmentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructures/{infrastructureIdentity}/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List applications on a chaos infrastructure
      effect: read
      questions:
      - Which applications were discovered on a given chaos infrastructure?
      - Can I see the apps running on one infra so I can target them with chaos?
      instructions:
      - text: List applications on infrastructure {infra} in environment {environment}.
        slots:
          infra: path.infrastructureIdentity
          environment: query.environmentIdentifier
      - text: Show the apps found on chaos infra {infra}.
        slots:
          infra: path.infrastructureIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructures/{infrastructureIdentity}/applications/{applicationIdentity}/functions'].get
  update:
    x-apievangelist-phrasing:
      intent: List instrumented functions of an application
      effect: read
      questions:
      - Which functions in an application are instrumented for chaos injection?
      - Can I see the instrumented functions of one app on a given infrastructure?
      instructions:
      - text: List instrumented functions of application {app} on infrastructure {infra}.
        slots:
          app: path.applicationIdentity
          infra: path.infrastructureIdentity
      - text: Show functions I can target in app {app} on infra {infra} in environment {environment}.
        slots:
          app: path.applicationIdentity
          infra: path.infrastructureIdentity
          environment: query.environmentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructures/{infrastructureIdentity}/token'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the token for a v2 chaos infrastructure
      effect: read
      questions:
      - Where do I get the access token a v2 chaos infrastructure uses to connect?
      - Can I retrieve the infra token for a chaos infrastructure in an environment?
      instructions:
      - text: Get the token for chaos infrastructure {infra} in environment {environment}.
        slots:
          infra: path.infrastructureIdentity
          environment: query.environmentIdentifier
      - text: Fetch the v2 infra token for {infra}.
        slots:
          infra: path.infrastructureIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/v2/infrastructures/{infrastructureIdentity}/updateemissary'].post
  update:
    x-apievangelist-phrasing:
      intent: Update the emissary endpoint of a chaos infra
      effect: write
      questions:
      - How do I change the emissary endpoint URL a chaos infrastructure reports to?
      - Can I point a v2 chaos infra at a new emissary URL?
      instructions:
      - text: Set the emissary endpoint of infrastructure {infra} to {url}.
        slots:
          infra: path.infrastructureIdentity
          url: requestBody.url
      - text: Update emissary URL for chaos infra {infra} in environment {environment} to {url}.
        slots:
          infra: path.infrastructureIdentity
          environment: query.environmentIdentifier
          url: requestBody.url
      method: generated
      generated: '2026-09-26'