API Evangelist conversational phrasing for Harness Tags API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Tags API
  version: 1.0.0
extends: openapi/harness-tags-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: 4
- target: $.paths['/cf/admin/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List feature flag tags
      effect: read
      questions:
      - What tags are used on feature flags in my project?
      - Can I filter the tag list by identifier?
      instructions:
      - text: List feature flag tags in project {project}.
        slots:
          project: query.projectIdentifier
      - text: Find tags matching {tag} in environment {env}.
        slots:
          tag: query.tagIdentifierFilter
          env: query.environmentIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a feature flag tag
      effect: write
      questions:
      - Can I create a new tag to organize feature flags?
      - What fields does a new flag tag need?
      instructions:
      - text: Create tag {name} with id {id} in project {project}.
        slots:
          name: requestBody.name
          id: requestBody.identifier
          project: query.projectIdentifier
      - text: Add a flag tag named {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/tags/{identifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a feature flag tag
      effect: read
      questions:
      - Which feature flags are associated with a specific tag?
      - Can I include archived flags when looking up a tag?
      instructions:
      - text: Get tag {tag} in project {project}.
        slots:
          tag: path.identifier
          project: query.projectIdentifier
      - text: Show tag {tag} including archived flags set to {archived}.
        slots:
          tag: path.identifier
          archived: query.archived
      method: generated
      generated: '2026-09-26'
- target: $.paths['/cf/admin/tags/{identifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a feature flag tag
      effect: destructive
      questions:
      - Can I delete a tag that's no longer needed?
      - Is force delete needed to remove a tag still used by flags?
      instructions:
      - text: Delete tag {tag} from project {project}.
        slots:
          tag: path.identifier
          project: query.projectIdentifier
      - text: Force delete tag {tag} with commit message {msg}.
        slots:
          tag: path.identifier
          msg: query.commitMsg
      method: generated
      generated: '2026-09-26'