# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Ansible API
  version: 1.0.0
extends: openapi/harness-ansible-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: 44
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/activities'].get
  update:
    x-apievangelist-phrasing:
      intent: List Ansible run activities in a project
      effect: read
      questions:
      - Which Ansible runs have happened recently in my Harness project?
      - Can I filter Ansible activity history by playbook, inventory or run status?
      instructions:
      - text: List Ansible activities in project {project} of org {org}.
        slots:
          project: path.project
          org: path.org
      - text: Show Ansible activities for playbook {playbook} with status {status} in {org}/{project}.
        slots:
          playbook: query.PlaybookSearchTerm
          status: query.status
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/activities/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Ansible activity record
      effect: read
      questions:
      - What happened in a specific Ansible activity I have the ID for?
      - Where can I see the details of a single Ansible run activity?
      instructions:
      - text: Show Ansible activity {id} in project {project} of org {org}.
        slots:
          id: path.id
          project: path.project
          org: path.org
      - text: Pull up the details of Ansible run activity {id} from {org}/{project}.
        slots:
          id: path.id
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/data'].get
  update:
    x-apievangelist-phrasing:
      intent: List stored Ansible data files
      effect: read
      questions:
      - What data files has Ansible stored for an inventory or playbook?
      - Can I find stored Ansible data from a particular pipeline execution?
      instructions:
      - text: List stored Ansible data in {org}/{project}.
        slots:
          org: path.org
          project: path.project
      - text: List Ansible data of type {data_type} from pipeline execution {execution} in {org}/{project}.
        slots:
          data_type: query.data_type
          execution: query.pipeline_execution_id
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/data'].post
  update:
    x-apievangelist-phrasing:
      intent: Store binary data produced by an Ansible run
      effect: write
      questions:
      - How do I upload binary output generated by Ansible into Harness?
      - Can I attach stored Ansible data to specific inventories and playbooks?
      instructions:
      - text: Store Ansible {data_type} data for inventories {inventories} and playbooks {playbooks} in {org}/{project}.
        slots:
          data_type: query.data_type
          inventories: query.inventories
          playbooks: query.playbooks
          org: path.org
          project: path.project
      - text: Upload Ansible {data_type} output from pipeline execution {execution} for inventories {inventories} and playbooks {playbooks} in {org}/{project}.
        slots:
          data_type: query.data_type
          execution: query.pipeline_execution_id
          inventories: query.inventories
          playbooks: query.playbooks
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/data/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download one stored Ansible data file
      effect: read
      questions:
      - Can I fetch a stored plan or state file the provisioner generated?
      - Where do I get the binary content of one stored Ansible data record?
      instructions:
      - text: Get stored Ansible data {id} from project {project} in org {org}.
        slots:
          id: path.id
          project: path.project
          org: path.org
      - text: Download the stored plan or state file {id} from {org}/{project}.
        slots:
          id: path.id
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Send an Ansible event to Harness
      effect: write
      questions:
      - How do I report an Ansible event for a set of playbooks and inventories?
      - Can I send event metadata along with an Ansible event?
      instructions:
      - text: Send an Ansible {event_type} event for playbooks {playbooks} and inventories {inventories} in {org}/{project}.
        slots:
          event_type: requestBody.event_type
          playbooks: requestBody.playbooks
          inventories: requestBody.inventories
          org: path.org
          project: path.project
      - text: Report a {event_type} event with metadata {metadata} for playbooks {playbooks} on inventories {inventories} in {org}/{project}.
        slots:
          event_type: requestBody.event_type
          metadata: requestBody.metadata
          playbooks: requestBody.playbooks
          inventories: requestBody.inventories
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/file'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch a playbook or inventory YAML from git
      effect: read
      questions:
      - Can I read the YAML of a playbook straight from its configured git repo?
      - Where do I get the plugin inventory file that lives in git?
      instructions:
      - text: Fetch the {resource_type} file for {identifier} from git in {org}/{project}.
        slots:
          resource_type: query.resource_type
          identifier: query.identifier
          org: path.org
          project: path.project
      - text: Read the playbook YAML for {identifier} from its git repo in {org}/{project}.
        slots:
          identifier: query.identifier
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/hosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List hosts across all Ansible inventories
      effect: read
      questions:
      - Which hosts does Ansible manage across every inventory in my project?
      - Can I list managed hosts filtered by status and time window?
      instructions:
      - text: List all Ansible hosts in {org}/{project}.
        slots:
          org: path.org
          project: path.project
      - text: List Ansible hosts in inventory {inventory} with status {status} in {org}/{project}.
        slots:
          inventory: query.inventory
          status: query.status
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/hosts/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details for one Ansible host
      effect: read
      questions:
      - What details does Harness keep about a single Ansible host?
      - Can I look up one managed host by its ID?
      instructions:
      - text: Show Ansible host {id} in project {project} of org {org}.
        slots:
          id: path.id
          project: path.project
          org: path.org
      - text: Look up managed host {id} in {org}/{project}.
        slots:
          id: path.id
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/hosts/{id}/activities'].get
  update:
    x-apievangelist-phrasing:
      intent: List activities for one Ansible host
      effect: read
      questions:
      - Which Ansible runs have touched a particular host?
      - Can I see the activity history of a single managed host?
      instructions:
      - text: List activities for Ansible host {id} in {org}/{project}.
        slots:
          id: path.id
          org: path.org
          project: path.project
      - text: Show the run history of host {id} in project {project} of org {org}, newest first.
        slots:
          id: path.id
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/hosts/{id}/inventories'].get
  update:
    x-apievangelist-phrasing:
      intent: List inventories a host belongs to
      effect: read
      questions:
      - Which Ansible inventories include a given host?
      - Is a particular host a member of more than one inventory?
      instructions:
      - text: List the inventories that host {id} belongs to in {org}/{project}.
        slots:
          id: path.id
          org: path.org
          project: path.project
      - text: Which inventories is host {id} a member of in project {project} of org {org}.
        slots:
          id: path.id
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/hosts/{id}/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get aggregated run stats for one host
      effect: read
      questions:
      - What are the aggregated run statistics for a specific Ansible host?
      - How often has one host succeeded or failed across its runs?
      instructions:
      - text: Get aggregated statistics for Ansible host {id} in {org}/{project}.
        slots:
          id: path.id
          org: path.org
          project: path.project
      - text: Show success and failure stats for host {id} in project {project} of org {org}.
        slots:
          id: path.id
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/hosts/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export Ansible hosts to CSV
      effect: read
      questions:
      - Can I download every matching Ansible host as a CSV file?
      - Is the host CSV export paginated or does it include all matches?
      instructions:
      - text: Export all Ansible hosts in {org}/{project} to CSV.
        slots:
          org: path.org
          project: path.project
      - text: Export Ansible hosts with status {status} from inventory {inventory} in {org}/{project} as CSV.
        slots:
          status: query.status
          inventory: query.inventory
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/hosts/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Count Ansible hosts by latest run status
      effect: read
      questions:
      - How many of my Ansible hosts are currently failing versus succeeding?
      - Can I get host counts grouped by last activity status for one inventory?
      instructions:
      - text: Summarize Ansible host counts by latest status in {org}/{project}.
        slots:
          org: path.org
          project: path.project
      - text: Give me the host status summary for inventory {inventory} in {org}/{project}.
        slots:
          inventory: query.inventory
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory'].get
  update:
    x-apievangelist-phrasing:
      intent: List Ansible inventories
      effect: read
      questions:
      - What Ansible inventories exist in my Harness project?
      - Can I search Ansible inventories by name or tag?
      instructions:
      - text: List Ansible inventories in {org}/{project}.
        slots:
          org: path.org
          project: path.project
      - text: Search Ansible inventories for {term} in {org}/{project}.
        slots:
          term: query.searchTerm
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Ansible inventory
      effect: write
      questions:
      - How do I set up a new Ansible inventory in Harness?
      - Can a new inventory be a plugin type with dynamic groups?
      instructions:
      - text: Create a {type} Ansible inventory named {name} with identifier {identifier} in {org}/{project}.
        slots:
          type: requestBody.type
          name: requestBody.name
          identifier: requestBody.identifier
          org: path.org
          project: path.project
      - text: Create a {type} inventory {name} ({identifier}) with plugin options {plugin_options} in {org}/{project}.
        slots:
          type: requestBody.type
          name: requestBody.name
          identifier: requestBody.identifier
          plugin_options: requestBody.plugin_options
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Ansible inventory
      effect: read
      questions:
      - What does a specific Ansible inventory contain?
      - Can I view one inventory's configuration by its identifier?
      instructions:
      - text: Show Ansible inventory {identifier} in {org}/{project}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Show inventory {identifier} in project {project} of org {org} with list values as arrays.
        slots:
          identifier: path.identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an Ansible inventory
      effect: write
      questions:
      - Can I rename an existing Ansible inventory or change its tags?
      - What do I send to replace an inventory's data?
      instructions:
      - text: Rename Ansible inventory {identifier} to {name} in {org}/{project}.
        slots:
          identifier: path.identifier
          name: requestBody.name
          org: path.org
          project: path.project
      - text: Replace the data of inventory {identifier} in {org}/{project} with {data}, keeping name {name}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
          data: requestBody.data
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Ansible inventory
      effect: destructive
      questions:
      - How do I remove an Ansible inventory I no longer need?
      - Can a whole inventory be deleted from a project?
      instructions:
      - text: Delete Ansible inventory {identifier} from {org}/{project}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Remove the whole inventory {identifier} from project {project} of org {org}.
        slots:
          identifier: path.identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}/ansible'].get
  update:
    x-apievangelist-phrasing:
      intent: Render an inventory as Ansible-compatible YAML
      effect: read
      questions:
      - Can I get an inventory in YAML that ansible-playbook can consume directly?
      - Is there a way to export one inventory in native Ansible format?
      instructions:
      - text: Render inventory {identifier} in {org}/{project} as Ansible-compatible YAML.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Export inventory {identifier} from project {project} of org {org} in native Ansible YAML format.
        slots:
          identifier: path.identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}/groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups in an Ansible inventory
      effect: read
      questions:
      - Which host groups are defined in an Ansible inventory?
      - Can I page through the groups of a large inventory?
      instructions:
      - text: List the groups in inventory {identifier} in {org}/{project}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Show the first {limit} host groups of inventory {identifier} in {org}/{project}.
        slots:
          limit: query.limit
          identifier: path.identifier
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}/hosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List hosts in one Ansible inventory
      effect: read
      questions:
      - Which hosts are in one particular inventory?
      - Can I list an inventory's hosts limited to a single group?
      instructions:
      - text: List hosts in inventory {identifier} in {org}/{project}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: List hosts in group {group} of inventory {identifier} in {org}/{project}.
        slots:
          group: query.group
          identifier: path.identifier
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}/hosts'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a host to an Ansible inventory
      effect: write
      questions:
      - How do I add a new host address to an existing inventory?
      - Can I assign groups and vars when adding a host to an inventory?
      instructions:
      - text: Add host {host_address} to inventory {identifier} in {org}/{project}.
        slots:
          host_address: requestBody.host_address
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Add host {host_address} to inventory {identifier} in groups {groups} in {org}/{project}.
        slots:
          host_address: requestBody.host_address
          identifier: path.identifier
          groups: requestBody.groups
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}/import'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace static inventory data from YAML or INI
      effect: write
      questions:
      - Can I overwrite an existing static inventory by pasting YAML or INI content?
      - Are secret references kept when I re-import a static inventory's data?
      instructions:
      - text: 'Replace the data of static inventory {identifier} in {org}/{project} with this {format} content: {content}'
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
          format: requestBody.format
          content: requestBody.content
      - text: 'Re-import {format} content into existing static inventory {identifier} in project {project} of org {org}, overwriting its data: {content}'
        slots:
          format: requestBody.format
          identifier: path.identifier
          project: path.project
          org: path.org
          content: requestBody.content
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}/plugin'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a plugin inventory's configuration
      effect: write
      questions:
      - How do I change the plugin options on a dynamic plugin inventory?
      - Can I reconfigure a plugin-based inventory without recreating it?
      instructions:
      - text: Set plugin options {plugin_options} on plugin inventory {identifier} in {org}/{project}.
        slots:
          plugin_options: requestBody.plugin_options
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Reconfigure dynamic plugin inventory {identifier} in project {project} of org {org} with plugin options {plugin_options}.
        slots:
          identifier: path.identifier
          project: path.project
          org: path.org
          plugin_options: requestBody.plugin_options
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}/vars'].get
  update:
    x-apievangelist-phrasing:
      intent: List variables on an Ansible inventory
      effect: read
      questions:
      - What variables are defined at the inventory level?
      - Can I see the vars attached to one Ansible inventory?
      instructions:
      - text: Show the variables of inventory {identifier} in {org}/{project}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: List inventory-level vars for {identifier} in project {project} of org {org}.
        slots:
          identifier: path.identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}/vars'].put
  update:
    x-apievangelist-phrasing:
      intent: Update existing inventory variables
      effect: write
      questions:
      - How do I change variables that already exist on an inventory?
      - Can I update an inventory's environment variables along with its vars?
      instructions:
      - text: Update existing vars on inventory {identifier} in {org}/{project} to {vars}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
          vars: requestBody.vars
      - text: Change environment variables already on inventory {identifier} in {org}/{project} to {env_vars}, with vars {vars}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
          env_vars: requestBody.env_vars
          vars: requestBody.vars
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{identifier}/vars'].post
  update:
    x-apievangelist-phrasing:
      intent: Add new variables to an inventory
      effect: write
      questions:
      - Can I define new variables on an inventory that has none yet?
      - Where do I add environment variables to an Ansible inventory for the first time?
      instructions:
      - text: Add new variables {vars} to inventory {identifier} in {org}/{project}.
        slots:
          vars: requestBody.vars
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Define new inventory vars {vars} and environment variables {env_vars} on inventory {identifier} in {org}/{project}.
        slots:
          vars: requestBody.vars
          env_vars: requestBody.env_vars
          identifier: path.identifier
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{inventory_identifier}/groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a group in an Ansible inventory
      effect: write
      questions:
      - How do I create a new host group inside an inventory?
      - Can an inventory group pull hosts dynamically through a connector?
      instructions:
      - text: Create group {name} with identifier {identifier} in inventory {inventory} in {org}/{project}.
        slots:
          name: requestBody.name
          identifier: requestBody.identifier
          inventory: path.inventory_identifier
          org: path.org
          project: path.project
      - text: Add a new group {name} ({identifier}) to inventory {inventory} in {org}/{project} containing hosts {hosts}.
        slots:
          name: requestBody.name
          identifier: requestBody.identifier
          inventory: path.inventory_identifier
          org: path.org
          project: path.project
          hosts: requestBody.hosts
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{inventory_identifier}/groups/{identifier}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a group in an Ansible inventory
      effect: write
      questions:
      - Can I change the hosts or vars of an existing inventory group?
      - What do I send to rename a group inside an inventory?
      instructions:
      - text: Rename group {identifier} in inventory {inventory} to {name} in {org}/{project}.
        slots:
          identifier: path.identifier
          inventory: path.inventory_identifier
          name: requestBody.name
          org: path.org
          project: path.project
      - text: Set the hosts of existing group {identifier} in inventory {inventory} to {hosts}, name {name}, in {org}/{project}.
        slots:
          identifier: path.identifier
          inventory: path.inventory_identifier
          hosts: requestBody.hosts
          name: requestBody.name
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{inventory_identifier}/groups/{identifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a group from an Ansible inventory
      effect: destructive
      questions:
      - How do I remove a host group from an inventory?
      - Can I delete one group without deleting the whole inventory?
      instructions:
      - text: Delete group {identifier} from inventory {inventory} in {org}/{project}.
        slots:
          identifier: path.identifier
          inventory: path.inventory_identifier
          org: path.org
          project: path.project
      - text: Remove host group {identifier} from inventory {inventory} in project {project} of org {org}.
        slots:
          identifier: path.identifier
          inventory: path.inventory_identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{inventory_identifier}/hosts/{host_address}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a host in an Ansible inventory
      effect: write
      questions:
      - Can I move an inventory host into different groups?
      - How do I change the vars set on one host in an inventory?
      instructions:
      - text: Put host {host_address} in inventory {inventory} into groups {groups} in {org}/{project}.
        slots:
          host_address: path.host_address
          inventory: path.inventory_identifier
          groups: requestBody.groups
          org: path.org
          project: path.project
      - text: Change the vars of host {host_address} in inventory {inventory} to {vars} in {org}/{project}.
        slots:
          host_address: path.host_address
          inventory: path.inventory_identifier
          vars: requestBody.vars
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/{inventory_identifier}/hosts/{host_address}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a host from an Ansible inventory
      effect: destructive
      questions:
      - What's the way to take a single host out of an inventory?
      - Can I delete a decommissioned server from my Ansible inventory?
      instructions:
      - text: Remove host {host_address} from inventory {inventory} in {org}/{project}.
        slots:
          host_address: path.host_address
          inventory: path.inventory_identifier
          org: path.org
          project: path.project
      - text: Take decommissioned host {host_address} out of inventory {inventory} in project {project} of org {org}.
        slots:
          host_address: path.host_address
          inventory: path.inventory_identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/inventory/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a static inventory from YAML or INI
      effect: write
      questions:
      - Can I import an existing hosts file in INI format as a new inventory?
      - How do I create a static inventory from YAML content I already have?
      instructions:
      - text: 'Import a new static inventory {name} ({identifier}) from this {format} content in {org}/{project}: {content}'
        slots:
          name: requestBody.name
          identifier: requestBody.identifier
          format: requestBody.format
          org: path.org
          project: path.project
          content: requestBody.content
      - text: 'Create static inventory {identifier} named {name} in {org}/{project} from my {format} hosts file: {content}'
        slots:
          identifier: requestBody.identifier
          name: requestBody.name
          org: path.org
          project: path.project
          format: requestBody.format
          content: requestBody.content
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/playbook'].get
  update:
    x-apievangelist-phrasing:
      intent: List Ansible playbooks
      effect: read
      questions:
      - Which Ansible playbooks are registered in my project?
      - Can I search playbooks by name or filter them by tag?
      instructions:
      - text: List Ansible playbooks in {org}/{project}.
        slots:
          org: path.org
          project: path.project
      - text: Search playbooks for {term} in {org}/{project}.
        slots:
          term: query.searchTerm
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/playbook'].post
  update:
    x-apievangelist-phrasing:
      intent: Register an Ansible playbook from a repo
      effect: write
      questions:
      - How do I register a playbook that lives in a git repository?
      - Can a new playbook include Ansible Galaxy requirements?
      instructions:
      - text: Create playbook {name} ({identifier}) at path {repository_path} in {org}/{project}.
        slots:
          name: requestBody.name
          identifier: requestBody.identifier
          repository_path: requestBody.repository_path
          org: path.org
          project: path.project
      - text: Register playbook {name} ({identifier}) from {repository_path} on branch {branch} using connector {connector} in {org}/{project}.
        slots:
          name: requestBody.name
          identifier: requestBody.identifier
          repository_path: requestBody.repository_path
          branch: requestBody.repository_branch
          connector: requestBody.repository_connector
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/playbook/{identifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Ansible playbook
      effect: read
      questions:
      - What repository and branch does a specific playbook point to?
      - Can I view one playbook's configuration?
      instructions:
      - text: Show playbook {identifier} in {org}/{project}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Which repo and branch does playbook {identifier} use in project {project} of org {org}.
        slots:
          identifier: path.identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/playbook/{identifier}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an Ansible playbook
      effect: write
      questions:
      - Can I point an existing playbook at a different repo path or branch?
      - What's required to change a playbook's name?
      instructions:
      - text: Update playbook {identifier} in {org}/{project} to use path {repository_path} on branch {branch}, keeping name {name}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
          repository_path: requestBody.repository_path
          branch: requestBody.repository_branch
          name: requestBody.name
      - text: Rename playbook {identifier} to {name} in {org}/{project}, keeping repo path {repository_path}.
        slots:
          identifier: path.identifier
          name: requestBody.name
          org: path.org
          project: path.project
          repository_path: requestBody.repository_path
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/playbook/{identifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Ansible playbook
      effect: destructive
      questions:
      - How do I remove a playbook from my Harness project?
      - Can I unregister a playbook I no longer run?
      instructions:
      - text: Delete playbook {identifier} from {org}/{project}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Unregister playbook {identifier} in project {project} of org {org}.
        slots:
          identifier: path.identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/playbook/{identifier}/vars'].get
  update:
    x-apievangelist-phrasing:
      intent: List variables on an Ansible playbook
      effect: read
      questions:
      - What dynamic variables are set on a playbook?
      - Can I see a playbook's variables page by page?
      instructions:
      - text: Show the variables of playbook {identifier} in {org}/{project}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: List the dynamic vars on playbook {identifier} in project {project} of org {org}.
        slots:
          identifier: path.identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/playbook/{identifier}/vars'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a dynamic playbook variable
      effect: write
      questions:
      - How do I change the value of an existing playbook variable?
      - Can I edit environment variables already defined on a playbook?
      instructions:
      - text: Update existing vars on playbook {identifier} in {org}/{project} to {vars}.
        slots:
          identifier: path.identifier
          org: path.org
          project: path.project
          vars: requestBody.vars
      - text: Edit the existing environment variables {env_vars} and vars {vars} on playbook {identifier} in {org}/{project}.
        slots:
          env_vars: requestBody.env_vars
          vars: requestBody.vars
          identifier: path.identifier
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/playbook/{identifier}/vars'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a dynamic playbook variable
      effect: write
      questions:
      - Can I add a brand new dynamic variable to a playbook?
      - Where do I define new env vars for a playbook run?
      instructions:
      - text: Add new variables {vars} to playbook {identifier} in {org}/{project}.
        slots:
          vars: requestBody.vars
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Define a new dynamic variable {vars} with env vars {env_vars} on playbook {identifier} in {org}/{project}.
        slots:
          vars: requestBody.vars
          env_vars: requestBody.env_vars
          identifier: path.identifier
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/playbook/{identifier}/vars'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete dynamic playbook variables
      effect: destructive
      questions:
      - How do I remove a variable from a playbook?
      - Can I delete specific dynamic vars from a playbook without touching the rest?
      instructions:
      - text: Delete variables {vars} from playbook {identifier} in {org}/{project}.
        slots:
          vars: requestBody.vars
          identifier: path.identifier
          org: path.org
          project: path.project
      - text: Drop the dynamic vars {vars} from playbook {identifier} in project {project} of org {org}.
        slots:
          vars: requestBody.vars
          identifier: path.identifier
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/iacm/api/orgs/{org}/projects/{project}/ansible/results'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish Ansible run results as an activity
      effect: write
      questions:
      - Can I store Ansible run results and log an activity in one call?
      - Which event type and data type do I pass when publishing Ansible results?
      instructions:
      - text: Publish {data_type} results as a {event_type} activity for playbooks {playbooks} and inventories {inventories} in {org}/{project}.
        slots:
          data_type: query.data_type
          event_type: query.event_type
          playbooks: query.playbooks
          inventories: query.inventories
          org: path.org
          project: path.project
      - text: Record execution {execution} results as a {event_type} activity with {data_type} data for playbooks {playbooks}, inventories {inventories}, in {org}/{project}.
        slots:
          execution: query.pipeline_execution_id
          event_type: query.event_type
          data_type: query.data_type
          playbooks: query.playbooks
          inventories: query.inventories
          org: path.org
          project: path.project
      method: generated
      generated: '2026-09-26'