# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Salesforce Items API
  version: 1.0.0
extends: openapi/salesforce-items-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/recent'].get
  update:
    x-apievangelist-phrasing:
      intent: Get recently viewed records of an object
      effect: read
      questions:
      - Which Accounts have I viewed most recently?
      - Can I cap how many recently viewed records come back?
      instructions:
      - text: Get my {limit} most recently viewed {sobject} records.
        slots:
          limit: query.limit
          sobject: path.SOBJECT_API_NAME
      - text: Show recently viewed {sobject} items, up to {limit}.
        slots:
          limit: query.limit
          sobject: path.SOBJECT_API_NAME
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/sobjects/relevantItems'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the current user's most relevant items
      effect: read
      questions:
      - What records are most relevant to me across objects I search?
      - How do I get the up to 50 most relevant records per object for the current user?
      instructions:
      - text: Get my relevant items.
      - text: Show the records most relevant to me across my search scope.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data/v64.0/ui-api/apps/{APP_ID}/user-nav-items'].put
  update:
    x-apievangelist-phrasing:
      intent: Reorder a user's personalized navigation items
      effect: write
      questions:
      - How do I change the order of a user's tabs in a Lightning app's navigation bar?
      - Can I add a navigation item to a user's personalized nav list?
      instructions:
      - text: Reorder my personalized navigation items in app {app_id}.
        slots:
          app_id: path.APP_ID
      - text: Update the nav bar tabs order for app {app_id}.
        slots:
          app_id: path.APP_ID
      method: generated
      generated: '2026-09-26'