# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Usergroups API
  version: 1.0.0
extends: openapi/harness-user-groups-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: 2
- target: $.paths['/code/api/v1/usergroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List user groups at account, org or project level
      effect: read
      questions:
      - Which user groups exist at my account, org or project level for code access?
      - Can I search user groups by name at a given level?
      instructions:
      - text: List user groups in project {project}.
        slots:
          project: query.projectIdentifier
      - text: Find user groups at org {org} level matching {query}.
        slots:
          org: query.orgIdentifier
          query: query.query
      method: generated
      generated: '2026-10-01'
- target: $.paths['/code/api/v1/usergroups/scoped'].get
  update:
    x-apievangelist-phrasing:
      intent: List user groups visible within a space
      effect: read
      questions:
      - Which user groups are in scope for a space, including ones inherited from parents?
      - Can I list the user groups usable within one code space?
      instructions:
      - text: List user groups scoped to the space of project {project}.
        slots:
          project: query.projectIdentifier
      - text: Show in-scope user groups for org space {org} named like {query}.
        slots:
          org: query.orgIdentifier
          query: query.query
      method: generated
      generated: '2026-10-01'