# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Account Role Assignments API
  version: 1.0.0
extends: openapi/harness-account-role-assignments-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v1/role-assignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List account-level role assignments
      effect: read
      questions:
      - Who has which roles at the account level in Harness?
      - Can I page and sort through all account role assignments?
      instructions:
      - text: List the role assignments in account {account}.
        slots:
          account: header.Harness-Account
      - text: Show account role assignments page {page}, {limit} per page.
        slots:
          page: query.page
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/role-assignments'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign a role to a principal at account level
      effect: write
      questions:
      - How do I grant a user a role across the whole account?
      - Can I bind a role to a resource group for a service account?
      instructions:
      - text: Assign role {role} on resource group {resource_group} to {principal} as {identifier}.
        slots:
          role: requestBody.role
          resource_group: requestBody.resource_group
          principal: requestBody.principal
          identifier: requestBody.identifier
      - text: Create account role assignment {identifier} giving {principal} the {role} role.
        slots:
          identifier: requestBody.identifier
          principal: requestBody.principal
          role: requestBody.role
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/role-assignments/{role-assignment}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an account-level role assignment
      effect: read
      questions:
      - Can I see which principal and resource group a specific role assignment covers?
      - What does one account role assignment grant?
      instructions:
      - text: Get role assignment {role_assignment}.
        slots:
          role_assignment: path.role-assignment
      - text: Show details of account role assignment {role_assignment}.
        slots:
          role_assignment: path.role-assignment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/role-assignments/{role-assignment}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke an account-level role assignment
      effect: destructive
      questions:
      - How do I take away a role someone was given at the account level?
      - Can I delete a single role assignment without touching the role?
      instructions:
      - text: Delete role assignment {role_assignment}.
        slots:
          role_assignment: path.role-assignment
      - text: Revoke account role assignment {role_assignment}.
        slots:
          role_assignment: path.role-assignment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/role-assignments/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count the role assignments in an account
      effect: read
      questions:
      - How many role assignments does my account have in total?
      - Is there a quick total of account role bindings?
      instructions:
      - text: Count the role assignments in account {account}.
        slots:
          account: header.Harness-Account
      - text: Give me the total number of role assignments.
      method: generated
      generated: '2026-09-26'