# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Cohesity Search API
  version: 1.0.0
extends: openapi/cohesity-search-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['/public/search/protectionRuns'].get
  update:
    x-apievangelist-phrasing:
      intent: Find an object's latest snapshot across targets
      effect: read
      questions:
      - Where is the latest snapshot of an object stored across all targets?
      - Can I look up an object's most recent backup by its UUID?
      instructions:
      - text: Find the latest snapshot of object {uuid} across all target locations.
        slots:
          uuid: query.uuid
      - text: Search protection runs for object UUID {uuid}.
        slots:
          uuid: query.uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/search/protectionSources'].get
  update:
    x-apievangelist-phrasing:
      intent: Search registered protection sources
      effect: read
      questions:
      - Which registered sources match a name, and are they protected?
      - Can I search Office 365 users by department or country?
      instructions:
      - text: Search protection sources for {searchString}.
        slots:
          searchString: query.searchString
      - text: Find Office 365 sources in department {departmentList}.
        slots:
          departmentList: query.departmentList
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-protect/search/indexed-objects'].post
  update:
    x-apievangelist-phrasing:
      intent: Search indexed files, emails and folders
      effect: read
      questions:
      - How do I find a specific file or email inside my backups?
      - Can I search indexed mailboxes within certain protection groups?
      instructions:
      - text: Search indexed objects of type {objectType}.
        slots:
          objectType: requestBody.objectType
      - text: Find indexed {objectType} items in protection groups {protectionGroupIds}.
        slots:
          objectType: requestBody.objectType
          protectionGroupIds: requestBody.protectionGroupIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-protect/search/objects'].get
  update:
    x-apievangelist-phrasing:
      intent: Search objects across sources
      effect: read
      questions:
      - Which VMs or databases match a name, protected or not?
      - Can I search objects by OS type or last run status?
      instructions:
      - text: Search objects matching {searchString}.
        slots:
          searchString: query.searchString
      - text: Find unprotected objects in environment {environments} with isProtected={isProtected}.
        slots:
          environments: query.environments
          isProtected: query.isProtected
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-protect/search/protected-objects'].get
  update:
    x-apievangelist-phrasing:
      intent: Search protected objects and their snapshots
      effect: read
      questions:
      - Which protected objects match a name and what snapshots do they have?
      - Can I limit protected-object search to CDP-protected objects only?
      instructions:
      - text: Search protected objects for {searchString}.
        slots:
          searchString: query.searchString
      - text: Find protected objects in storage domain {storageDomainIds} with snapshots after {filterSnapshotFromUsecs}.
        slots:
          storageDomainIds: query.storageDomainIds
          filterSnapshotFromUsecs: query.filterSnapshotFromUsecs
      method: generated
      generated: '2026-10-01'