# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign REST Authentication API
  version: 1.0.0
extends: openapi/docusign-authentication-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: 4
- target: $.paths['/v2/login_information'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the accounts the signed-in user can access
      effect: read
      questions:
      - Which accounts does my authenticated user have access to?
      - Can I get account ID GUIDs along with my login information?
      instructions:
      - text: Show the accounts my login has access to.
      - text: 'Get my login information including account ID GUIDs: {include_account_id_guid}.'
        slots:
          include_account_id_guid: query.include_account_id_guid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/login_information/{loginPart}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a user's password
      effect: write
      questions:
      - Can I change my password through the API?
      - What do I need to provide to set a new login password?
      instructions:
      - text: Change the password for {email} from {currentPassword} to {newPassword} via {loginPart}.
        slots:
          email: requestBody.email
          currentPassword: requestBody.currentPassword
          newPassword: requestBody.newPassword
          loginPart: path.loginPart
      - text: Update the {loginPart} login setting with my new password.
        slots:
          loginPart: path.loginPart
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/oauth2/revoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Revoke a legacy OAuth token
      effect: destructive
      questions:
      - Can I revoke an access token with the older deprecated OAuth endpoint?
      - Is the legacy token revocation call still supported?
      instructions:
      - text: Revoke my current token using the deprecated OAuth revoke endpoint.
      - text: Invalidate the legacy OAuth authorization token.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/oauth2/token'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a legacy OAuth token
      effect: write
      questions:
      - Can I still get an access token from the deprecated OAuth token endpoint?
      - Is the old token creation endpoint recommended for new integrations?
      instructions:
      - text: Create an authorization token using the deprecated OAuth token endpoint.
      - text: Request a legacy OAuth access token.
      method: generated
      generated: '2026-10-01'