# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Approvals Backup Delegates API
  version: 1.0.0
extends: openapi/conga-backupdelegates-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['/v1/backup-delegates'].get
  update:
    x-apievangelist-phrasing:
      intent: List backup and delegate approvers
      effect: read
      questions:
      - Who is set up as a backup or delegate approver?
      - Can I filter the backup and delegate approver list?
      instructions:
      - text: List backup and delegate approvers.
      - text: Find backup or delegate approvers matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/backup-delegates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update a backup or delegate approver
      effect: write
      questions:
      - How do I set someone as my backup approver while I'm out of office?
      - Can I give a delegate approver an effective and expiration date?
      instructions:
      - text: Make {BackupUser} my backup approver from {EffectiveDate} to {ExpirationDate}.
        slots:
          BackupUser: requestBody.BackupUser
          EffectiveDate: requestBody.EffectiveDate
          ExpirationDate: requestBody.ExpirationDate
      - text: Add delegates {DelegateUserIds} for my approvals.
        slots:
          DelegateUserIds: requestBody.DelegateUserIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/backup-delegates/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Count backup and delegate approvers
      effect: read
      questions:
      - How many backup and delegate approvers are active versus inactive?
      - Is there a total count of backup approver records?
      instructions:
      - text: Count backup and delegate approvers.
      - text: Give me backup and delegate stats.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/backup-delegates/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backup or delegate approver record
      effect: read
      questions:
      - What are the dates and users on one backup assignment?
      - Can I look up a single delegate record by ID?
      instructions:
      - text: Show backup or delegate record {id}.
        slots:
          id: path.id
      - text: Get the details of delegate assignment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/backup-delegates/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a backup or delegate approver record
      effect: destructive
      questions:
      - Can I remove a backup approver assignment entirely?
      - What happens if I delete a delegate record?
      instructions:
      - text: Delete backup or delegate record {id}.
        slots:
          id: path.id
      - text: Remove delegate assignment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/backup-delegates/{id}/activate'].post
  update:
    x-apievangelist-phrasing:
      intent: Activate a backup or delegate
      effect: write
      questions:
      - Can I turn a saved backup assignment on now?
      - Is there a way to activate a delegate even if validation warns?
      instructions:
      - text: Activate backup or delegate record {id}.
        slots:
          id: path.id
      - text: Activate delegate {id} with continue-on-validate set to {continueOnValidate}.
        slots:
          id: path.id
          continueOnValidate: query.continueOnValidate
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/backup-delegates/{id}/deactivate'].post
  update:
    x-apievangelist-phrasing:
      intent: Deactivate a backup or delegate
      effect: write
      questions:
      - Can I switch off a backup approver when I'm back in office?
      - Which call stops a delegate assignment without deleting it?
      instructions:
      - text: Deactivate backup or delegate record {id}.
        slots:
          id: path.id
      - text: Turn off delegate assignment {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'