API Evangelist conversational phrasing for Kubex Subscriptions 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 Kubex Subscriptions Tags API
  version: 1.0.0
extends: openapi/densify-subscriptions-tags-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/subscriptions/{platformType}/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List subscription tags for a platform
      effect: read
      questions:
      - Which tags are in the containers catalog for subscriptions?
      - Can I list only global tags?
      instructions:
      - text: List tags in the {platformType} catalog.
        slots:
          platformType: path.platformType
      - text: Show only {type}-scoped tags for {platformType}, owned by {owner}.
        slots:
          type: query.type
          platformType: path.platformType
          owner: query.owner
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{platformType}/tags'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace several tags at once
      effect: write
      questions:
      - Can I edit multiple catalog tags in one request?
      - Is a bulk tag replace all-or-nothing?
      instructions:
      - text: Replace a batch of tags in the {platformType} catalog.
        slots:
          platformType: path.platformType
      - text: Overwrite multiple {platformType} catalog tags in one all-or-nothing edit.
        slots:
          platformType: path.platformType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{platformType}/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Add tags to a catalog in bulk
      effect: write
      questions:
      - How do I add resource tags to the subscription catalog?
      - Can a non-admin create global tags?
      instructions:
      - text: Add new tags to the {platformType} catalog.
        slots:
          platformType: path.platformType
      - text: Register several resource tags in the {platformType} subscription catalog.
        slots:
          platformType: path.platformType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{platformType}/tags'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several tags at once
      effect: destructive
      questions:
      - Can I delete a list of catalog tags in one call?
      - What if some tags in a bulk delete are still used by subscriptions?
      instructions:
      - text: Delete a list of tags from the {platformType} catalog.
        slots:
          platformType: path.platformType
      - text: Remove multiple tags from {platformType} in one request.
        slots:
          platformType: path.platformType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{platformType}/tags/{tagRef}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one catalog tag
      effect: read
      questions:
      - How do I look up a single tag by its ID?
      - Which attribute does a specific catalog tag map to?
      instructions:
      - text: Get tag {tagRef} from the {platformType} catalog.
        slots:
          tagRef: path.tagRef
          platformType: path.platformType
      - text: Show the details of {platformType} catalog tag {tagRef}.
        slots:
          platformType: path.platformType
          tagRef: path.tagRef
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{platformType}/tags/{tagRef}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a single tag
      effect: write
      questions:
      - How do I rename one catalog tag or change its attribute?
      - Can I promote a private tag to global?
      instructions:
      - text: Replace tag {tagRef} in {platformType} with name {tagName} and attribute {attributeName}.
        slots:
          tagRef: path.tagRef
          platformType: path.platformType
          tagName: requestBody.tagName
          attributeName: requestBody.attributeName
      - text: Set tag {tagRef} in {platformType} to {tagName} on attribute {attributeName} with key {key}.
        slots:
          tagRef: path.tagRef
          platformType: path.platformType
          tagName: requestBody.tagName
          attributeName: requestBody.attributeName
          key: requestBody.key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{platformType}/tags/{tagRef}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one tag
      effect: destructive
      questions:
      - How do I remove a single tag from the catalog?
      - What happens if I delete a tag a subscription still uses?
      instructions:
      - text: Delete tag {tagRef} from the {platformType} catalog.
        slots:
          tagRef: path.tagRef
          platformType: path.platformType
      - text: Remove the single tag {tagRef} from {platformType}.
        slots:
          tagRef: path.tagRef
          platformType: path.platformType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List tags (default cloud alias)
      effect: read
      questions:
      - Can I list catalog tags without naming the platform?
      - Is there a short endpoint for cloud tags?
      instructions:
      - text: List tags using the default cloud alias.
      - text: Show cloud catalog tags without specifying a platform.
      method: generated
      generated: '2026-10-01'