# 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 Protection Objects API
  version: 1.0.0
extends: openapi/cohesity-protectionobjects-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: 4
- target: $.paths['/public/protectionObjects'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a protected object's settings
      effect: write
      questions:
      - Can I pause backups for a single protected object?
      - Can I move an already-protected object to a different RPO policy?
      instructions:
      - text: Pause backups for protected object {protectedSourceUid}.
        slots:
          protectedSourceUid: requestBody.protectedSourceUid
      - text: Move protected object {protectedSourceUid} to RPO policy {rpoPolicyId}.
        slots:
          protectedSourceUid: requestBody.protectedSourceUid
          rpoPolicyId: requestBody.rpoPolicyId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/protectionObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: Protect objects under an RPO policy
      effect: write
      questions:
      - How do I start protecting a VM or server with an RPO policy?
      - Can several sources be protected under one RPO policy at once?
      instructions:
      - text: Protect sources {protectionSourceIds} with RPO policy {rpoPolicyId}.
        slots:
          protectionSourceIds: requestBody.protectionSourceIds
          rpoPolicyId: requestBody.rpoPolicyId
      - text: Start RPO protection of {protectionSourceIds} in environment {protectionSourceEnvironment} under {rpoPolicyId}.
        slots:
          protectionSourceIds: requestBody.protectionSourceIds
          protectionSourceEnvironment: requestBody.protectionSourceEnvironment
          rpoPolicyId: requestBody.rpoPolicyId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/protectionObjects'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unprotect an object from an RPO policy
      effect: destructive
      questions:
      - Can I stop protecting an object and also delete its existing snapshots?
      - What is required to remove an object from its RPO policy?
      instructions:
      - text: Unprotect source {protectionSourceId} from RPO policy {rpoPolicyId}.
        slots:
          protectionSourceId: requestBody.protectionSourceId
          rpoPolicyId: requestBody.rpoPolicyId
      - text: Unprotect {protectionSourceId} from {rpoPolicyId} and delete its snapshots.
        slots:
          protectionSourceId: requestBody.protectionSourceId
          rpoPolicyId: requestBody.rpoPolicyId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/protectionObjects/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a protected object's job summary
      effect: read
      questions:
      - Which protection job is backing up a given object, and how is it protected?
      - Can I see the protection summary of one source?
      instructions:
      - text: Show the protection summary for source {protectionSourceId}.
        slots:
          protectionSourceId: query.protectionSourceId
      - text: Find the protection job covering source {protectionSourceId}.
        slots:
          protectionSourceId: query.protectionSourceId
      method: generated
      generated: '2026-10-01'