# 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 External Connection API
  version: 1.0.0
extends: openapi/cohesity-external-connection-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: 10
- target: $.paths['/connection-bifrost'].get
  update:
    x-apievangelist-phrasing:
      intent: List Bifrost connections
      effect: read
      questions:
      - Which Bifrost connections are configured on the cluster?
      - Can I list Bifrost connections for just one tenant?
      instructions:
      - text: List all Bifrost connections.
      - text: Show the Bifrost connections for tenant {tenantId}.
        slots:
          tenantId: query.tenantId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/connection-bifrost'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Bifrost connection
      effect: write
      questions:
      - How do I set up a Bifrost connection for a tenant?
      - What subnet does a new Bifrost connection need?
      instructions:
      - text: Create a Bifrost connection for tenant {tenantId} on subnet {subnet}.
        slots:
          tenantId: requestBody.tenantId
          subnet: requestBody.subnet
      - text: Add Bifrost connection {name} for tenant {tenantId} using subnet {subnet}.
        slots:
          name: requestBody.name
          tenantId: requestBody.tenantId
          subnet: requestBody.subnet
      method: generated
      generated: '2026-10-01'
- target: $.paths['/connection-bifrost/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Bifrost connection
      effect: read
      questions:
      - What are the settings of one Bifrost connection?
      - Which subnet and certificate version does a given Bifrost connection use?
      instructions:
      - text: Get Bifrost connection {id}.
        slots:
          id: path.id
      - text: Show the details of Bifrost connection {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/connection-bifrost/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Bifrost connection
      effect: write
      questions:
      - Can I change the subnet of an existing Bifrost connection?
      - How do I bump the certificate version on a Bifrost connection?
      instructions:
      - text: Update Bifrost connection {id} for tenant {tenantId} to subnet {subnet}.
        slots:
          id: path.id
          tenantId: requestBody.tenantId
          subnet: requestBody.subnet
      - text: Set certificate version {certificateVersion} on Bifrost connection {id}.
        slots:
          certificateVersion: requestBody.certificateVersion
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/connection-bifrost/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Bifrost connection
      effect: destructive
      questions:
      - How do I remove a Bifrost connection I no longer use?
      - Is deleting a Bifrost connection reversible?
      instructions:
      - text: Delete Bifrost connection {id}.
        slots:
          id: path.id
      - text: Remove the Bifrost connection with id {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/connection-rigel'].get
  update:
    x-apievangelist-phrasing:
      intent: List Rigel connections
      effect: read
      questions:
      - Which Rigel connections exist on the cluster?
      - Can I find Rigel connections by name?
      instructions:
      - text: List all Rigel connections.
      - text: Show Rigel connections named {names}.
        slots:
          names: query.names
      method: generated
      generated: '2026-10-01'
- target: $.paths['/connection-rigel'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Rigel connection
      effect: write
      questions:
      - How do I register a Rigel connection for a tenant?
      - What fields does a new Rigel connection require?
      instructions:
      - text: Create Rigel connection {name} with id {connectionId} for tenant {tenantId}.
        slots:
          name: requestBody.name
          connectionId: requestBody.connectionId
          tenantId: requestBody.tenantId
      - text: Add a Rigel connection {connectionId} named {name} under tenant {tenantId}.
        slots:
          connectionId: requestBody.connectionId
          name: requestBody.name
          tenantId: requestBody.tenantId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/connection-rigel/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Rigel connection
      effect: read
      questions:
      - What does a single Rigel connection look like?
      - Which tenant owns a particular Rigel connection?
      instructions:
      - text: Get Rigel connection {id}.
        slots:
          id: path.id
      - text: Show details for the Rigel connection with id {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/connection-rigel/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Rigel connection
      effect: write
      questions:
      - Can I rename an existing Rigel connection?
      - How do I move a Rigel connection to a different tenant?
      instructions:
      - text: Rename Rigel connection {id} to {name} for tenant {tenantId}.
        slots:
          id: path.id
          name: requestBody.name
          tenantId: requestBody.tenantId
      - text: Update Rigel connection {id} to belong to tenant {tenantId} with name {name}.
        slots:
          id: path.id
          tenantId: requestBody.tenantId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/connection-rigel/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Rigel connection
      effect: destructive
      questions:
      - How do I remove a Rigel connection?
      - What happens to a tenant's access when its Rigel connection is deleted?
      instructions:
      - text: Delete Rigel connection {id}.
        slots:
          id: path.id
      - text: Remove the Rigel connection with id {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'