api.yaml in vgs_api_client-0.0.1.alpha202204291540 vs api.yaml in vgs_api_client-0.0.1.alpha202205021651

@@ -37,10 +37,11 @@
     ## Resource Limits
     
     ### Data Limits
     
     This API allows storing data up to 32MB in size.
+    This limit is applied to the size of the JSON data sent per each value, which includes extra metadata.
 
     ### Rate Limiting
 
     The API allows up to 3,000 requests per minute. Requests are associated with
     the vault, regardless of the access credentials used to authenticate the
@@ -120,9 +121,14 @@
       tags:
         - aliases
       summary: Create aliases
       description: |
         Stores multiple values at once & returns their aliases.
+
+        The number of values sent should not exceed 20.
+
+        The JSON object for each value should not exceed 32MB. This limit is
+        per value sent, which includes its classifiers, format, and storage.
 
         Alternatively, this endpoint may be used to associate additional (i.e.
         secondary) aliases with the same underlying data as the reference
         alias specified in the request body.