# 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 Tenants API
  version: 1.0.0
extends: openapi/cohesity-tenants-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: 4
- target: $.paths['/tenants/swift'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tenant's Swift configuration
      effect: read
      questions:
      - What Swift object storage settings does a tenant have?
      - Which Keystone configuration is a tenant's Swift tied to?
      instructions:
      - text: Get the Swift configuration for tenant {tenantId}.
        slots:
          tenantId: query.tenantId
      - text: Show the Swift configuration.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tenants/swift'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a tenant's Swift configuration
      effect: write
      questions:
      - Can I change which Keystone a tenant's Swift service uses?
      - How do I set which roles may operate on Swift for a tenant?
      instructions:
      - text: Update Swift for tenant {tenantId} to use Keystone {keystoneId}.
        slots:
          tenantId: requestBody.tenantId
          keystoneId: requestBody.keystoneId
      - text: Set Swift operator roles for tenant {tenantId} to {operatorRoles}.
        slots:
          tenantId: requestBody.tenantId
          operatorRoles: requestBody.operatorRoles
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tenants/swift/register'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a tenant's Swift service with Keystone
      effect: write
      questions:
      - How do I register Swift for a tenant on a Keystone server?
      - What credentials are needed to register Swift with Keystone?
      instructions:
      - text: Register Swift for tenant {tenantId} on Keystone.
        slots:
          tenantId: requestBody.tenantId
      - text: Register tenant {tenantId}'s Swift service using Keystone credentials {keystoneCredentials}.
        slots:
          tenantId: requestBody.tenantId
          keystoneCredentials: requestBody.keystoneCredentials
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tenants/swift/unregister'].post
  update:
    x-apievangelist-phrasing:
      intent: Unregister a tenant's Swift service from Keystone
      effect: destructive
      questions:
      - How do I remove a tenant's Swift service from Keystone?
      - Can I unregister Swift for one tenant only?
      instructions:
      - text: Unregister Swift for tenant {tenantId} from Keystone.
        slots:
          tenantId: requestBody.tenantId
      - text: Remove tenant {tenantId}'s Swift registration using credentials {keystoneCredentials}.
        slots:
          tenantId: requestBody.tenantId
          keystoneCredentials: requestBody.keystoneCredentials
      method: generated
      generated: '2026-10-01'