API Evangelist conversational phrasing for AppConnect V3 Contact 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 AppConnect V3 Contact Tags API
  version: 1.0.0
extends: openapi/constant-contact-contact-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: 5
- target: $.paths['/contact_tags/{tag_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one tag's details
      effect: read
      questions:
      - What are the details of a specific tag?
      - Can I see how many contacts have a particular tag?
      instructions:
      - text: Show tag {tag_id}.
        slots:
          tag_id: path.tag_id
      - text: Get tag {tag_id} including how many contacts carry it.
        slots:
          tag_id: path.tag_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contact_tags/{tag_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a tag
      effect: write
      questions:
      - Can I rename a tag I already created?
      - Is there a length limit on a tag's new name?
      instructions:
      - text: Rename tag {tag_id} to {name}.
        slots:
          tag_id: path.tag_id
          name: requestBody.name
      - text: Change the name of tag {tag_id} to {name}.
        slots:
          tag_id: path.tag_id
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contact_tags/{tag_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single tag
      effect: destructive
      questions:
      - Does deleting one tag remove it from all my contacts?
      - Can I check on the progress of a tag deletion?
      instructions:
      - text: Delete tag {tag_id}.
        slots:
          tag_id: path.tag_id
      - text: Unassign tag {tag_id} from everyone and delete it.
        slots:
          tag_id: path.tag_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contact_tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List all tags
      effect: read
      questions:
      - Which tags exist in my account?
      - Can I see contact counts for every tag at once?
      instructions:
      - text: List all my tags.
      - text: List my tags with contact counts, {limit} per page.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contact_tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a tag
      effect: write
      questions:
      - How do I create a new contact tag?
      - Must tag names be unique?
      instructions:
      - text: Create a tag named {name}.
        slots:
          name: requestBody.name
      - text: Create tag {name} with source {tag_source}.
        slots:
          name: requestBody.name
          tag_source: requestBody.tag_source
      method: generated
      generated: '2026-10-01'