# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Site Continuity v2 Service Applications API
  version: 1.0.0
extends: openapi/cohesity-applications-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: 7
- target: $.paths['/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List DR applications
      effect: read
      questions:
      - Which applications are defined for disaster recovery?
      - Can I filter DR applications by site or status?
      instructions:
      - text: List all DR applications.
      - text: List applications on sites {siteIds} with status {statuses}.
        slots:
          siteIds: query.siteIds
          statuses: query.statuses
      - text: Find applications named {appNames} including summary {includeSummary}.
        slots:
          appNames: query.appNames
          includeSummary: query.includeSummary
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a DR application
      effect: write
      questions:
      - How do I group objects, delays and scripts into an application for DR?
      - Do I need to pick a site when creating an application?
      instructions:
      - text: Create application {name} on site {siteId} with spec {spec}.
        slots:
          name: requestBody.name
          siteId: requestBody.siteId
          spec: requestBody.spec
      - text: Define a new DR app {name} at site {siteId} using spec {spec}.
        slots:
          name: requestBody.name
          siteId: requestBody.siteId
          spec: requestBody.spec
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one DR application
      effect: read
      questions:
      - What objects and scripts make up a given application?
      - Which site does a specific application belong to?
      instructions:
      - text: Show application {id}.
        slots:
          id: path.id
      - text: Get the details of DR app {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a DR application
      effect: write
      questions:
      - How do I change the objects or scripts in an existing application?
      - Can I rename an application I already created?
      instructions:
      - text: Update application {id} with name {name}, site {siteId} and spec {spec}.
        slots:
          id: path.id
          name: requestBody.name
          siteId: requestBody.siteId
          spec: requestBody.spec
      - text: Replace the spec of existing app {id} ({name} on {siteId}) with {spec}.
        slots:
          id: path.id
          name: requestBody.name
          siteId: requestBody.siteId
          spec: requestBody.spec
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a DR application
      effect: destructive
      questions:
      - How do I delete an application I no longer protect?
      - Why can't I delete an application that a DR plan still uses?
      instructions:
      - text: Delete application {id}.
        slots:
          id: path.id
      - text: Remove DR app {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{id}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions of a DR application
      effect: read
      questions:
      - What versions has an application gone through?
      - Can I fetch only specific versions of an application?
      instructions:
      - text: List the versions of application {id}.
        slots:
          id: path.id
      - text: Get versions {versions} of app {id}.
        slots:
          versions: query.versions
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{id}/replicated-snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List replicated snapshots for an application
      effect: read
      questions:
      - What's the latest replicated snapshot for each object in my application?
      - Can I see replicated snapshots within a time range?
      instructions:
      - text: Show replicated snapshots for application {id}.
        slots:
          id: path.id
      - text: List replicated snapshots of app {id} from {fromTimeUsecs} to {toTimeUsecs}.
        slots:
          id: path.id
          fromTimeUsecs: query.fromTimeUsecs
          toTimeUsecs: query.toTimeUsecs
      - text: Get replicated snapshots for objects {objectIds} in app {id}.
        slots:
          objectIds: query.objectIds
          id: path.id
      method: generated
      generated: '2026-10-01'