chore(docs): Generated API Reference (#4706)

Co-authored-by: olivermrbl <olivermrbl@users.noreply.github.com>
Co-authored-by: Shahed Nasser <shahednasser@gmail.com>

docs/api/admin/components/schemas/User.yaml

@@ -1,5 +1,5 @@
 title: User
-description: Represents a User who can manage store settings.
+description: A User is an administrator who can manage store settings and data.
 type: object
 required:
   - api_token
@@ -18,7 +18,7 @@ properties:
     type: string
     example: usr_01G1G5V26F5TB3GPAPNJ8X1S3V
   role:
-    description: The user's role
+    description: The user's role. These roles don't provide any different privileges.
     type: string
     enum:
       - admin
@@ -63,3 +63,7 @@ properties:
     type: object
     example:
       car: white
+    externalDocs:
+      description: Learn about the metadata attribute, and how to delete and update it.
+      url: >-
+        https://docs.medusajs.com/development/entities/overview#metadata-attribute