# 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 DR Plan API
  version: 1.0.0
extends: openapi/cohesity-drplan-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: 9
- target: $.paths['/dr-plans'].get
  update:
    x-apievangelist-phrasing:
      intent: List disaster recovery plans
      effect: read
      questions:
      - Which DR plans are currently violating their SLA?
      - Can I list DR plans that fail over to a particular DR site?
      instructions:
      - text: List DR plans named {drPlanNames}.
        slots:
          drPlanNames: query.drPlanNames
      - text: Show DR plans with primary site {primarySiteIds}, including a summary.
        slots:
          primarySiteIds: query.primarySiteIds
      - text: List DR plans whose SLA status is {slaStatus}.
        slots:
          slaStatus: query.slaStatus
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dr-plans'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a disaster recovery plan
      effect: write
      questions:
      - How do I set up a DR plan that pairs a primary site with a recovery site?
      - Can I set a recovery point objective when creating a DR plan?
      instructions:
      - text: Create DR plan {name} from primary site {primarySite} to DR site {drSite} with RPO {rpo}.
        slots:
          name: requestBody.name
          primarySite: requestBody.primarySite
          drSite: requestBody.drSite
          rpo: requestBody.rpo
      - text: Create DR plan {name} for application {appId}, primary {primarySite}, DR site {drSite}, RPO {rpo}.
        slots:
          name: requestBody.name
          appId: requestBody.appId
          primarySite: requestBody.primarySite
          drSite: requestBody.drSite
          rpo: requestBody.rpo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dr-plans/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a disaster recovery plan
      effect: read
      questions:
      - How do I see the full configuration of one DR plan?
      - What sites and RPO does a specific DR plan use?
      instructions:
      - text: Get DR plan {id}.
        slots:
          id: path.id
      - text: Show the details of DR plan {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dr-plans/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a disaster recovery plan
      effect: write
      questions:
      - Can I change the RPO on an existing DR plan?
      - How would I point a DR plan at a different recovery site?
      instructions:
      - text: Update DR plan {id} with RPO {rpo}, keeping name {name}, primary {primarySite} and DR site {drSite}.
        slots:
          id: path.id
          rpo: requestBody.rpo
          name: requestBody.name
          primarySite: requestBody.primarySite
          drSite: requestBody.drSite
      - text: Rename DR plan {id} to {name} with primary {primarySite}, DR site {drSite}, RPO {rpo}.
        slots:
          id: path.id
          name: requestBody.name
          primarySite: requestBody.primarySite
          drSite: requestBody.drSite
          rpo: requestBody.rpo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dr-plans/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a disaster recovery plan
      effect: destructive
      questions:
      - How do I remove a DR plan I no longer need?
      - Is deleting a DR plan reversible?
      instructions:
      - text: Delete DR plan {id}.
        slots:
          id: path.id
      - text: Remove disaster recovery plan {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dr-plans/{id}/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Fail over, fail back or test a DR plan
      effect: write
      questions:
      - How do I trigger a failover to the DR site for one of my plans?
      - Can I run a test failover without affecting production?
      - What does a teardown do after a test failover?
      instructions:
      - text: Perform action {action} on DR plan {id}.
        slots:
          action: requestBody.action
          id: path.id
      - text: Run a test failover on DR plan {id} with parameters {testFailoverParams}.
        slots:
          id: path.id
          testFailoverParams: requestBody.testFailoverParams
      - text: Fail back DR plan {id} using {failbackParams}.
        slots:
          id: path.id
          failbackParams: requestBody.failbackParams
      method: generated
      generated: '2026-10-01'
- target: $.paths['/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: List actions taken on DR plans
      effect: read
      questions:
      - Which failovers or failbacks have run on my DR plans this week?
      - Can I see step-level details for DR actions that failed?
      instructions:
      - text: List actions on DR plans {drPlanIds}.
        slots:
          drPlanIds: query.drPlanIds
      - text: Show DR actions of type {types} with status {statuses}.
        slots:
          types: query.types
          statuses: query.statuses
      method: generated
      generated: '2026-10-01'
- target: $.paths['/actions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a DR plan action
      effect: read
      questions:
      - How do I check the status of one failover action?
      - Can I see each step of a specific DR action?
      instructions:
      - text: Get DR action {id}.
        slots:
          id: path.id
      - text: Show DR action {id} with step details.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/actions/{id}/operations'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel, resume or force-finish a DR action
      effect: write
      questions:
      - Can I cancel a failover that's already in progress?
      - How do I resume a DR action that got stuck partway?
      instructions:
      - text: Perform operation {operationType} on DR action {id}.
        slots:
          operationType: requestBody.operationType
          id: path.id
      - text: Cancel DR action {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'