diff --git a/swagger.yaml b/swagger.yaml
index 7eeb6572..e0069e4a 100644
--- a/swagger.yaml
+++ b/swagger.yaml
@@ -9,7 +9,7 @@ info:
     name: AGPL
     url: https://github.com/nextcloud/passman/blob/master/LICENSE
 # the domain of the service
-host: localhost
+host: api.uber.com
 # array of all schemes that your API supports
 schemes:
   - https
@@ -321,7 +321,7 @@ definitions:
       vault_id:
         type: integer
         format: int64
-        description: The id of the vault
+        description: The id of the vault, generated by uniqid()
       name:
         type: string
         description: Name of the vault
@@ -336,6 +336,7 @@ definitions:
       item_id:
         type: integer
         format: int64
+        description: generated by uniqid()
       user_id:
         type: string
       vault:
@@ -425,7 +426,7 @@ definitions:
       file_id:
         type: integer
         format: int64
-        description: The file id
+        description: The file id, generated by uniqid()
       filename: 
         type: string
         description: The uploaded file name
@@ -440,7 +441,7 @@ definitions:
         description: Size of the file in bytes
       file_data:
         type: string
-        description: sjcl encrypted file
+        description: sjcl encrypted file (only given when downloading a file)
       created:
         type: string
         format: dateTime