# 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 Users API
  version: 1.0.0
extends: openapi/cohesity-users-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: 3
- target: $.paths['/security-principals'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up security principals by SID
      effect: read
      questions:
      - Which user or group does a given SID belong to?
      - Can I resolve several SIDs to principals at once?
      instructions:
      - text: Look up security principals for SIDs {sids}.
        slots:
          sids: query.sids
      - text: Resolve SID {sids} to its user or group.
        slots:
          sids: query.sids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/sessions'].post
  update:
    x-apievangelist-phrasing:
      intent: Log in and create a user session
      effect: write
      questions:
      - How do I log in to the cluster API with a username and password?
      - Can I start a session with certificate-based authentication instead of a password?
      instructions:
      - text: Create a session for {username} in domain {domain}.
        slots:
          username: requestBody.username
          domain: requestBody.domain
      - text: Log in as {username} with password {password}.
        slots:
          username: requestBody.username
          password: requestBody.password
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/sessions'].delete
  update:
    x-apievangelist-phrasing:
      intent: Sign out user sessions
      effect: destructive
      questions:
      - How do I force a user to be logged out everywhere?
      - What happens if I end sessions without naming a user?
      instructions:
      - text: Delete all sessions for user {sid}.
        slots:
          sid: query.sid
      - text: End all system-wide user sessions.
      method: generated
      generated: '2026-10-01'