# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Actions API
  version: 1.0.0
extends: openapi/harness-actions-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: 8
- target: $.paths['/gateway/chaos/manager/api/rest/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: List chaos actions
      effect: read
      questions:
      - What chaos actions are available in my project?
      - Can I filter chaos actions by infrastructure type or chaos hub?
      instructions:
      - text: List chaos actions matching {search}, page {page} with {limit} per page.
        slots:
          search: query.search
          page: query.page
          limit: query.limit
      - text: Show actions for infrastructure type {infra} in project {project}.
        slots:
          infra: query.infraType
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a chaos action
      effect: write
      questions:
      - How do I define a new custom action for chaos experiments?
      - Can I base a new action on an existing action template?
      instructions:
      - text: Create a chaos action named {name} of type {type}.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: Create action {name} from template {template}.
        slots:
          name: requestBody.name
          template: requestBody.actionsTemplateRef
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/actions/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import a chaos action from a hub
      effect: write
      questions:
      - Can I import an existing action from a chaos hub into my project?
      - What's needed to bring a referenced action into this project?
      instructions:
      - text: Import action {action_ref} as {name} with identity {identity} using import type {import_type}.
        slots:
          action_ref: requestBody.actionRef
          name: requestBody.name
          identity: requestBody.identity
          import_type: requestBody.importType
      - text: Bring action {action_ref} in from hub {hub}.
        slots:
          action_ref: requestBody.actionRef
          hub: requestBody.hubRef
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/actions/manifest/{identity}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a chaos action's manifest
      effect: read
      questions:
      - Can I download the manifest behind a chaos action?
      - Where do I see the raw definition an action is built from?
      instructions:
      - text: Get the manifest for action {identity}.
        slots:
          identity: path.identity
      - text: Show the raw action manifest of {identity}.
        slots:
          identity: path.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/actions/{identity}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a chaos action
      effect: read
      questions:
      - What are the details and inputs of a specific chaos action?
      - Can I look up one action by its identifier?
      instructions:
      - text: Get chaos action {identity}.
        slots:
          identity: path.identity
      - text: Show details of action {identity} in project {project}.
        slots:
          identity: path.identity
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/actions/{identity}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a chaos action
      effect: write
      questions:
      - Can I change the inputs or run properties of an existing action?
      - Is renaming a chaos action supported?
      instructions:
      - text: Update action {identity} in account {account_id} with name {name}.
        slots:
          identity: path.identity
          account_id: requestBody.accountID
          name: requestBody.name
      - text: Change the description of action {identity} to {description}.
        slots:
          identity: path.identity
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/rest/actions/{identity}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a chaos action
      effect: destructive
      questions:
      - Can I delete a chaos action we don't use anymore?
      - What's the way to remove a custom action from a project?
      instructions:
      - text: Delete chaos action {identity}.
        slots:
          identity: path.identity
      - text: Remove action {identity} from project {project}.
        slots:
          identity: path.identity
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/chaos/manager/api/v3/actions/list-metadata'].post
  update:
    x-apievangelist-phrasing:
      intent: List metadata for chaos actions
      effect: read
      questions:
      - Can I get lightweight metadata for a set of actions by their identifiers?
      - Which actions carry a given tag, without pulling full details?
      instructions:
      - text: Get metadata for actions {identifiers}.
        slots:
          identifiers: requestBody.identifiers
      - text: List action metadata tagged {tags}.
        slots:
          tags: query.tags
      method: generated
      generated: '2026-09-26'