diff --git a/api/v1/swagger/definitions/vendor_alias.yaml b/api/v1/swagger/definitions/vendor_alias.yaml
index 435388524b..59af4177a3 100644
--- a/api/v1/swagger/definitions/vendor_alias.yaml
+++ b/api/v1/swagger/definitions/vendor_alias.yaml
@@ -1,11 +1,11 @@
 ---
 type: object
 properties:
-  alias_id:
-    description: Internal ID for the extended attribute
+  vendor_alias_id:
+    description: Internally assigned vendor alias identifier
     type: integer
   vendor_id:
-    description: ID of the vendor
+    description: Internally assigned vendor alias identifier
     type: integer
   alias:
     description: The alias
diff --git a/api/v1/swagger/swagger.yaml b/api/v1/swagger/swagger.yaml
index d38e04e820..5092aa22da 100644
--- a/api/v1/swagger/swagger.yaml
+++ b/api/v1/swagger/swagger.yaml
@@ -186,6 +186,8 @@ definitions:
     $ref: ./definitions/transfer_limit.yaml
   vendor:
     $ref: ./definitions/vendor.yaml
+  vendor_alias:
+    $ref: ./definitions/vendor_alias.yaml
   vendor_issue:
     $ref: ./definitions/vendor_issue.yaml
   vendors_config: