api.yaml in vgs_api_client-0.0.1.alpha202306061541 vs api.yaml in vgs_api_client-0.0.1.alpha202306071620

@@ -22,11 +22,30 @@
     
     - [Create an Account for Free Tokenization](https://dashboard.verygoodsecurity.com/tokenization)
     - [Try a Tokenization Demo](https://www.verygoodsecurity.com/docs/tokenization/getting-started)
     - [Install a Tokenization SDK](https://www.verygoodsecurity.com/docs/tokenization/client-libraries)
     
-    ### Authentication
+    ## Introduction
+    
+    ### Alias-Formats
+    | Format                          | Description                                                                               |
+    |---------------------------------|-------------------------------------------------------------------------------------------|
+    | UUID                            | Generic - VGS Alias (Default) - tok_sandbox_xxxxxxxxxxxxxxxxxxxxxxxxx                     |
+    | NUM_LENGTH_PRESERVING           | Generic - Numeric Length Preserving - xxxxxxxxxxxxxxxx                                    |
+    | FPE_SIX_T_FOUR                  | Payment Card - Format Preserving, Luhn Valid (6T4) - <first_six>xxxxxx<last_four>         |
+    | FPE_T_FOUR                      | Payment Card - Format Preserving, Luhn Valid (T4) - xxxxxxxxxxxx<last_four>               |
+    | PFPT                            | Payment Card - Prefixed, Luhn Valid, 19 Digits Fixed Length - xxxxxxxxxxxxxxxxxxx         |
+    | NON_LUHN_FPE_ALPHANUMERIC       | Payment Card - Format Preserving - Non Luhn Valid - xxxxxxxxxxxxxxxx                      |
+    | FPE_SSN_T_FOUR                  | SSN - Format Preserving (A4) - xxx-xx-<last_four>                                         |
+    | FPE_ACC_NUM_T_FOUR              | Account Number - Numeric Length Preserving (A4) - xxxxxxxxxxxx<last_four>                 |
+    | FPE_ALPHANUMERIC_ACC_NUM_T_FOUR | Account Number - Alphanumeric Length Preserving (A4) - xxxxxxxxxxxx<last_four>            |
+    | GENERIC_T_FOUR                  | Generic - VGS Alias Last Four (T4) - tok_sandbox_xxxxxxxxxxxxxxxxxxxxxxxxx_<last_four>    |
+    | RAW_UUID                        | Generic - UUID - xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx                                     |
+    | ALPHANUMERIC_SIX_T_FOUR         | Numeric - Include Alphanumeric, 19 symbols length (6T4) - <first_six>xxxxxxxxx<last_four> |
+    | VGS_FIXED_LEN_GENERIC           | Generic - VGS Alphanumeric Fixed Length, 29 characters - vgsxxxxxxxxxxxxxxxxxxxxxxxxxx    | 
+    
+    ## Authentication
 
     This API uses `Basic` authentication and is implemented using industry best practices to ensure the security of the connection. Read more about [Identity and Access Management at VGS](https://www.verygoodsecurity.com/docs/vault/the-platform/iam)
 
     Credentials to access the API can be generated on the
     [dashboard](https://dashboard.verygoodsecurity.com) by going to the Settings
@@ -258,11 +277,15 @@
             curl https://api.sandbox.verygoodvault.com/aliases?aliases={{alias1}},{{alias2}}?storage=PERSISTENT \
              -u "$USERNAME:$PASSWORD"
 
   /aliases/delete:
     post:
-      summary: "POST aliases/delete"
+      summary: "Batch Delete Aliases"
       operationId: "deleteAliases"
+      tags:
+        - aliases
+      description: |
+        Deletes multiple aliases.
       requestBody:
         content:
           application/json:
             schema:
               $ref: "#/components/schemas/BatchAliasesRequest"