# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Postman O Auth20 API
  version: 1.0.0
extends: openapi/postman-oauth-2-0-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: 2
- target: $.paths['/oauth2/token'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an OAuth access token for a client app
      effect: write
      questions:
      - How does a backend service or bot get an OAuth token without a user?
      - Which grant type does token generation support?
      instructions:
      - text: Generate an access token with grant {grant_type} for installation {installationAuthId} using JWT {jwt}.
        slots:
          grant_type: requestBody.grant_type
          installationAuthId: requestBody.installationAuthId
          jwt: requestBody.jwt
      - text: Get a client credentials token for installation {installationAuthId} signed with {jwt}, grant {grant_type}.
        slots:
          installationAuthId: requestBody.installationAuthId
          jwt: requestBody.jwt
          grant_type: requestBody.grant_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/oauth2/token/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke an OAuth access token
      effect: destructive
      questions:
      - Can a revoked OAuth token be restored?
      - How do I immediately invalidate an OAuth access token?
      instructions:
      - text: Revoke OAuth access token {token}.
        slots:
          token: requestBody.token
      - text: Invalidate this OAuth token now.
      method: generated
      generated: '2026-10-01'