# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mapp Fashion Authorization API
  version: 1.0.0
extends: openapi/mapp-authorization-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['/oauth/authorize'].get
  update:
    x-apievangelist-phrasing:
      intent: Start OAuth sign-in to get a grant code
      effect: read
      questions:
      - How do I begin the OAuth flow to get an access token?
      - Is PKCE required when requesting authorization?
      instructions:
      - text: Start authorization for client {client_id} redirecting to {redirect_uri} with challenge {code_challenge} via {code_challenge_method}.
        slots:
          client_id: query.client_id
          redirect_uri: query.redirect_uri
          code_challenge: query.code_challenge
          code_challenge_method: query.code_challenge_method
      - text: Request a {response_type} grant with state {state}.
        slots:
          response_type: query.response_type
          state: query.state
      method: generated
      generated: '2026-09-26'
- target: $.paths['/oauth/token'].post
  update:
    x-apievangelist-phrasing:
      intent: Exchange a grant code or refresh token for a JWT
      effect: write
      questions:
      - How do I swap my authorization code for an access token?
      - Can I refresh an expired access token with my refresh token?
      instructions:
      - text: Exchange code {code} for a token with verifier {code_verifier} for client {client_id}.
        slots:
          code: requestBody.code
          code_verifier: requestBody.code_verifier
          client_id: requestBody.client_id
      - text: Refresh my token using {refresh_token} with grant type {grant_type}, redirect {redirect_uri}.
        slots:
          refresh_token: requestBody.refresh_token
          grant_type: requestBody.grant_type
          redirect_uri: requestBody.redirect_uri
      method: generated
      generated: '2026-09-26'