# 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 Keystone API
  version: 1.0.0
extends: openapi/cohesity-keystone-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['/keystones'].get
  update:
    x-apievangelist-phrasing:
      intent: List Keystone configurations
      effect: read
      questions:
      - Which OpenStack Keystone configurations are set up on my cluster?
      - Can I filter Keystones by name or tenant?
      instructions:
      - text: List all Keystone configurations.
      - text: Find Keystones named {names}.
        slots:
          names: query.names
      - text: List Keystones for tenants {tenantIds}.
        slots:
          tenantIds: query.tenantIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/keystones'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Keystone configuration
      effect: write
      questions:
      - How do I add a Keystone identity configuration to the cluster?
      - Can I register a new Keystone endpoint through the API?
      instructions:
      - text: Create a new Keystone configuration.
      - text: Add a Keystone identity setup to the cluster.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/keystones/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Keystone configuration
      effect: read
      questions:
      - What settings does a specific Keystone config have?
      - Can I look up a Keystone by its id?
      instructions:
      - text: Show Keystone {id}.
        slots:
          id: path.id
      - text: Get the Keystone configuration with id {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/keystones/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Keystone configuration
      effect: write
      questions:
      - How do I change an existing Keystone configuration?
      - Can I edit a Keystone after it's been created?
      instructions:
      - text: Update Keystone configuration {id}.
        slots:
          id: path.id
      - text: Modify the settings of Keystone {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/keystones/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Keystone configuration
      effect: destructive
      questions:
      - How do I delete a Keystone configuration?
      - Why does removing a Keystone require the admin password?
      instructions:
      - text: Delete Keystone {id} using admin password {adminPassword}.
        slots:
          id: path.id
          adminPassword: header.adminPassword
      - text: Remove Keystone configuration {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'