# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Salesforce Connect API
  version: 1.0.0
extends: openapi/salesforce-connect-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['/.well-known/openid-configuration'].get
  update:
    x-apievangelist-phrasing:
      intent: Get OpenID Connect discovery metadata
      effect: read
      questions:
      - Where are the OpenID Connect endpoints and supported scopes listed?
      - What does the openid-configuration document advertise?
      instructions:
      - text: Get the OpenID Connect discovery document.
      - text: Fetch the openid-configuration metadata.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/oauth2/introspect'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether a token is still active
      effect: read
      questions:
      - How can I tell if an access or refresh token is still valid?
      - Can I introspect a token to see its details?
      instructions:
      - text: Introspect token {token} as a {token_type_hint}.
        slots:
          token: requestBody.token
          token_type_hint: requestBody.token_type_hint
      - text: Check whether {token} is still active.
        slots:
          token: requestBody.token
      method: generated
      generated: '2026-09-26'