# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Auth0 Authentication OAuth Token API
  version: 1.0.0
extends: openapi/auth0-oauth-token-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 1
- target: $.paths['/oauth/token'].post
  update:
    x-apievangelist-phrasing:
      intent: Get tokens via any supported OAuth grant
      effect: write
      questions:
      - Can I get an access token with client credentials for a machine-to-machine app?
      - Which grant types does the token endpoint support, like PKCE, refresh token or device code?
      - Is it possible to complete an MFA challenge with a one-time password or recovery code at the token endpoint?
      instructions:
      - text: Request an access token from the token endpoint.
      - text: Exchange a refresh token for new tokens, forwarding the end user IP {auth0-forwarded-for}.
        slots:
          auth0-forwarded-for: header.auth0-forwarded-for
      method: generated
      generated: '2026-10-01'