API Evangelist conversational phrasing for Cohesity 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 Cohesity Tags API
  version: 1.0.0
extends: openapi/cohesity-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: 7
- target: $.paths['/public/tags/apply'].put
  update:
    x-apievangelist-phrasing:
      intent: Apply tags to backed-up objects
      effect: write
      questions:
      - Can I tag files or snapshots from a backup job run so they are easier to find?
      - Which backup items can tags be applied to?
      instructions:
      - text: Apply tags {tags} to entity {entityId} in job {jobId}.
        slots:
          tags: requestBody.tags
          entityId: requestBody.entityId
          jobId: requestBody.jobId
      - text: Tag documents {documentIds} with {tags}.
        slots:
          documentIds: requestBody.documentIds
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/tags/remove'].put
  update:
    x-apievangelist-phrasing:
      intent: Remove tags from backed-up objects
      effect: write
      questions:
      - Can I take tags off backed-up files or snapshots?
      - How are tags cleared from an entity in a job run?
      instructions:
      - text: Remove tags {tags} from entity {entityId} in job {jobId}.
        slots:
          tags: requestBody.tags
          entityId: requestBody.entityId
          jobId: requestBody.jobId
      - text: Untag documents {documentIds} from {tags}.
        slots:
          documentIds: requestBody.documentIds
          tags: requestBody.tags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List tags
      effect: read
      questions:
      - Which tags are defined on the cluster, by name or namespace?
      - Can I include tags already marked for deletion?
      instructions:
      - text: List tags in namespaces {namespaces}.
        slots:
          namespaces: query.namespaces
      - text: Find tags named {names}.
        slots:
          names: query.names
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a tag
      effect: write
      questions:
      - How do I define a new tag with a namespace and color?
      - Can a tag have a description and a UI color?
      instructions:
      - text: Create tag {name} in namespace {namespace}.
        slots:
          name: requestBody.name
          namespace: requestBody.namespace
      - text: Create tag {name} in {namespace} with color {uiColor}.
        slots:
          name: requestBody.name
          namespace: requestBody.namespace
          uiColor: requestBody.uiColor
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tags/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag
      effect: read
      questions:
      - What are the details of one tag?
      - Can I look up a tag by its id?
      instructions:
      - text: Get tag {id}.
        slots:
          id: path.id
      - text: Show the definition of tag {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tags/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a tag
      effect: write
      questions:
      - Can I rename an existing tag or change its color?
      - Which fields must be included when editing a tag?
      instructions:
      - text: Rename tag {id} to {name} in namespace {namespace}.
        slots:
          id: path.id
          name: requestBody.name
          namespace: requestBody.namespace
      - text: Change the description of tag {id} to {description}, keeping name {name} and namespace {namespace}.
        slots:
          id: path.id
          description: requestBody.description
          name: requestBody.name
          namespace: requestBody.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tags/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tag
      effect: destructive
      questions:
      - Can I delete a tag I no longer use?
      - What removes a tag definition by id?
      instructions:
      - text: Delete tag {id}.
        slots:
          id: path.id
      - text: Remove tag definition {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'