# 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 Protected Objects API
  version: 1.0.0
extends: openapi/cohesity-protected-objects-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: 3
- target: $.paths['/data-protect/protected-objects'].post
  update:
    x-apievangelist-phrasing:
      intent: Back up objects of any type
      effect: write
      questions:
      - Can I protect any kind of object with object-level backup?
      - What's the newer data-protect way to add object backups?
      instructions:
      - text: Create object backups for {objects}.
        slots:
          objects: requestBody.objects
      - text: Protect objects {objects} with object-level backup.
        slots:
          objects: requestBody.objects
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-protect/protected-objects/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Pause, resume, run or unprotect objects
      effect: write
      questions:
      - Can I pause or resume backups on protected objects in bulk?
      - Can I trigger an immediate backup run for a protected object?
      instructions:
      - text: Perform {action} on the protected objects.
        slots:
          action: requestBody.action
      - text: Run {action} now with parameters {runNowParams}.
        slots:
          action: requestBody.action
          runNowParams: requestBody.runNowParams
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data-protect/protected-objects/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an object backup configuration
      effect: write
      questions:
      - Can I change the backup settings of one protected object by its id?
      - Which environment-specific settings, like VMware or SQL, can be updated for an object backup?
      instructions:
      - text: Update the object backup config of {id}.
        slots:
          id: path.id
      - text: Change the {environment} backup settings for object {id}.
        slots:
          environment: requestBody.environment
          id: path.id
      method: generated
      generated: '2026-10-01'