# 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 Roles API
  version: 1.0.0
extends: openapi/cohesity-roles-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['/public/roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List roles on the cluster
      effect: read
      questions:
      - What roles are defined on my Cohesity cluster and what privileges do they carry?
      - Can I look up a single role by name?
      instructions:
      - text: List all roles on the cluster.
      - text: Show the role named {name}.
        slots:
          name: query.name
      - text: List roles for tenants {tenantIds}.
        slots:
          tenantIds: query.tenantIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom role
      effect: write
      questions:
      - How do I create a custom role with a specific set of privileges?
      - Can I add a description to a new role?
      instructions:
      - text: Create custom role {name} with privileges {privileges}.
        slots:
          name: requestBody.name
          privileges: requestBody.privileges
      - text: Add role {name} described as {description}.
        slots:
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/roles'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete custom roles
      effect: destructive
      questions:
      - How do I delete custom roles I no longer need?
      - Can I remove several roles in a single call?
      instructions:
      - text: Delete roles {names}.
        slots:
          names: requestBody.names
      - text: Remove the custom roles named {names}.
        slots:
          names: requestBody.names
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/roles/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom role
      effect: write
      questions:
      - How do I change the privileges assigned to a custom role?
      - Can I update a role's description?
      instructions:
      - text: Set the privileges of role {name} to {privileges}.
        slots:
          name: path.name
          privileges: requestBody.privileges
      - text: Change the description of role {name} to {description}.
        slots:
          name: path.name
          description: requestBody.description
      method: generated
      generated: '2026-10-01'