# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cohesity REST View Boxes API
  version: 1.0.0
extends: openapi/cohesity-viewboxes-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['/public/viewBoxes'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage domains
      effect: read
      questions:
      - Which storage domains (View Boxes) exist on my cluster?
      - Can I include usage and performance stats when listing storage domains?
      instructions:
      - text: List all storage domains.
      - text: Show storage domains named {names} with usage stats.
        slots:
          names: query.names
      - text: List storage domains in cluster partition {clusterPartitionIds}.
        slots:
          clusterPartitionIds: query.clusterPartitionIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/viewBoxes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a storage domain
      effect: write
      questions:
      - How do I create a new storage domain with its own dedup and compression settings?
      - Can I put a physical quota on a new storage domain?
      instructions:
      - text: Create storage domain {name} in cluster partition {clusterPartitionId}.
        slots:
          name: requestBody.name
          clusterPartitionId: requestBody.clusterPartitionId
      - text: Create storage domain {name} in partition {clusterPartitionId} with storage policy {storagePolicy}.
        slots:
          name: requestBody.name
          clusterPartitionId: requestBody.clusterPartitionId
          storagePolicy: requestBody.storagePolicy
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/viewBoxes/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a storage domain
      effect: read
      questions:
      - What are the settings and quotas of one storage domain?
      - How much space is a specific storage domain using?
      instructions:
      - text: Get storage domain {id}.
        slots:
          id: path.id
      - text: Show storage domain {id} with usage and performance stats.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/viewBoxes/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a storage domain
      effect: write
      questions:
      - How do I raise the physical quota on an existing storage domain?
      - Can I map an existing storage domain to an LDAP provider?
      instructions:
      - text: Update storage domain {id} named {name} in partition {clusterPartitionId} with quota {physicalQuota}.
        slots:
          id: path.id
          name: requestBody.name
          clusterPartitionId: requestBody.clusterPartitionId
          physicalQuota: requestBody.physicalQuota
      - text: Map storage domain {id} to LDAP provider {ldapProviderId}.
        slots:
          id: path.id
          ldapProviderId: requestBody.ldapProviderId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/viewBoxes/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a storage domain (View Box endpoint)
      effect: destructive
      questions:
      - How do I delete a View Box through the public viewBoxes endpoint?
      - Is deleting a View Box permanent?
      instructions:
      - text: Delete View Box {id} via the public viewBoxes endpoint.
        slots:
          id: path.id
      - text: Remove View Box {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'