Update api.yml

openAPI/api.yml

@@ -78,7 +78,8 @@ paths:
     get:
       security:
       - ApiKeyAuth: []
-      description: Retrieve all available accounts on the system.
+      description: >-
+        This endpoint allows you to retrieve the configured settlement accounts for each supported blockchain network within the BoomFi platform. This endpoint provides essential information regarding the accounts established for receiving payments across various networks, along with the associated currencies enabled for each network.
       consumes:
       - application/json
       produces:
@@ -193,7 +194,10 @@ paths:
     get:
       security:
       - ApiKeyAuth: []
-      description: Use this endpoint to generate a variant URL of an existing payment link.
+      description: >-
+        This endpoint allows merchants to programmatically alter the amount and currency of an existing paylink identified by its unique identifier.
+
+        It enables merchants to dynamically adjust payment links, allowing flexibility in charging different amounts and currencies based on specific scenarios. Merchants can programmatically modify existing paylinks to suit various use cases such as checkout amounts, account balance top-ups, donations, or tipping using cryptocurrency.
       consumes:
       - application/json
       produces: