# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Salesforce Lists API
  version: 1.0.0
extends: openapi/salesforce-lists-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/sobjects/{SOBJECT_API_NAME}/listviews'].get
  update:
    x-apievangelist-phrasing:
      intent: List an object's list views
      effect: read
      questions:
      - Which list views exist for the Contact object?
      - How do I get the IDs of an object's list views?
      instructions:
      - text: List the list views for {sobject}.
        slots:
          sobject: path.SOBJECT_API_NAME
      - text: Get all list view IDs and names on {sobject}.
        slots:
          sobject: path.SOBJECT_API_NAME
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/sobjects/{SOBJECT_API_NAME}/listviews/{LIST_VIEW_ID}/results'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the results of a list view
      effect: read
      questions:
      - How do I get the records a list view shows, with its columns?
      - What SOQL query sits behind a particular list view?
      instructions:
      - text: Get results of list view {list_view_id} on {sobject}.
        slots:
          list_view_id: path.LIST_VIEW_ID
          sobject: path.SOBJECT_API_NAME
      - text: Show the columns and rows of {sobject} list view {list_view_id}.
        slots:
          list_view_id: path.LIST_VIEW_ID
          sobject: path.SOBJECT_API_NAME
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/support/knowledgeArticles'].get
  update:
    x-apievangelist-phrasing:
      intent: List online knowledge articles
      effect: read
      questions:
      - How do I get a page of published knowledge articles for a language?
      - Can I browse online articles by data category?
      instructions:
      - text: List online knowledge articles.
      - text: Get a page of published articles from the knowledge base.
      method: generated
      generated: '2026-09-26'