# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Salesforce Approvals API
  version: 1.0.0
extends: openapi/salesforce-approvals-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/data/v64.0/process/approvals'].get
  update:
    x-apievangelist-phrasing:
      intent: List all approval processes
      effect: read
      questions:
      - Which approval processes are defined in my org?
      - Can I see every approval process an object supports?
      instructions:
      - text: List all approval processes in the org.
      - text: Show me the approval processes I can submit records to.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/process/approvals'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit, approve or reject a record for approval
      effect: write
      questions:
      - How do I submit a record into an approval process from code?
      - Can I approve or reject a pending request and name the next approver?
      instructions:
      - text: Submit record {record_id} for approval with the comment {comments}.
        slots:
          record_id: requestBody.contextId
          comments: requestBody.comments
      - text: Perform {action} on {record_id} via process {process}, next approver {approvers}.
        slots:
          action: requestBody.actionType
          record_id: requestBody.contextId
          process: requestBody.processDefinitionNameOrId
          approvers: requestBody.nextApproverIds
      method: generated
      generated: '2026-09-26'