# 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 Audit Log API
  version: 1.0.0
extends: openapi/cohesity-audit-log-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['/audit-logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Search cluster audit logs (v2)
      effect: read
      questions:
      - Who changed what on the cluster yesterday, according to the audit-logs API?
      - Can I filter audit logs by user, action and entity type?
      instructions:
      - text: Get audit logs for users {usernames}.
        slots:
          usernames: query.usernames
      - text: Search audit logs for {searchString} between {startTimeUsecs} and {endTimeUsecs}.
        slots:
          searchString: query.searchString
          startTimeUsecs: query.startTimeUsecs
          endTimeUsecs: query.endTimeUsecs
      method: generated
      generated: '2026-10-01'
- target: $.paths['/audit-logs/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: List audit log actions (v2)
      effect: read
      questions:
      - Which action values can I filter the audit-logs endpoint by?
      - What kinds of actions does the cluster record in its v2 audit logs?
      instructions:
      - text: List the audit log action types from the audit-logs API.
      - text: Show every action value for filtering v2 audit logs.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/audit-logs/entity-types'].get
  update:
    x-apievangelist-phrasing:
      intent: List audit log entity types
      effect: read
      questions:
      - Which entity types appear in cluster audit logs?
      - What object types can I narrow audit logs to?
      instructions:
      - text: List audit log entity types.
      - text: Show the entity types I can filter audit logs by.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/audit-logs/filer-configs'].get
  update:
    x-apievangelist-phrasing:
      intent: Get filer audit log configs
      effect: read
      questions:
      - Where are filer audit logs written, and over which SMB or NFS mount paths?
      - What subnet whitelist applies to filer audit logs?
      instructions:
      - text: Show the filer audit log configuration.
      - text: Get the filer audit log mount paths and whitelist.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/audit-logs/filer-configs'].put
  update:
    x-apievangelist-phrasing:
      intent: Update filer audit log configs
      effect: write
      questions:
      - Can I change the NFS or SMB mount paths for filer audit logs?
      - Can filer audit logs override the global subnet whitelist?
      instructions:
      - text: Set filer audit log NFS mount paths to {nfsMountPaths}.
        slots:
          nfsMountPaths: requestBody.nfsMountPaths
      - text: Update the filer audit log subnet whitelist to {subnetWhitelist}.
        slots:
          subnetWhitelist: requestBody.subnetWhitelist
      method: generated
      generated: '2026-10-01'