# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Salesforce Expression API
  version: 1.0.0
extends: openapi/salesforce-expression-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: 3
- target: $.paths['/data/v64.0/connect/business-rules/expression-set/{expressionSetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a business rules expression set
      effect: read
      questions:
      - What steps and versions does an expression set contain?
      - Can I read an expression set's definition by its ID?
      instructions:
      - text: Get expression set {expressionSetId}.
        slots:
          expressionSetId: path.expressionSetId
      - text: Show the definition and versions of expression set {expressionSetId}.
        slots:
          expressionSetId: path.expressionSetId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/connect/business-rules/expression-set/{expressionSetId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an expression set
      effect: write
      questions:
      - Can I rename an expression set or change its usage type?
      - How do I add a new version to an existing expression set?
      instructions:
      - text: Update expression set {expressionSetId} with versions {versions}.
        slots:
          expressionSetId: path.expressionSetId
          versions: requestBody.versions
      - text: Rename expression set {expressionSetId} to {name}.
        slots:
          expressionSetId: path.expressionSetId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/connect/business-rules/expressionset/{expressionSetAPIName}'].post
  update:
    x-apievangelist-phrasing:
      intent: Run an expression set against inputs
      effect: read
      questions:
      - How do I evaluate business rules by invoking an expression set with my inputs?
      - What output does an expression set return when I run it by API name?
      instructions:
      - text: Invoke expression set {expressionSetAPIName} with inputs {inputs}.
        slots:
          expressionSetAPIName: path.expressionSetAPIName
          inputs: requestBody.inputs
      - text: Run the {expressionSetAPIName} rules on {inputs} using options {options}.
        slots:
          expressionSetAPIName: path.expressionSetAPIName
          inputs: requestBody.inputs
          options: requestBody.options
      method: generated
      generated: '2026-09-26'