some fixes and changes

packages/spec/specs/components/activity.yaml

@@ -21,8 +21,10 @@ properties:
         invalid-credentials,
       ]
   action_by:
-    $ref: "./user.yaml"
     description: The user who caused this action.
+    oneOf:
+      - type: string
+      - $ref: "../openapi.yaml#/components/schemas/User"
     nullable: true # States the SQL structure
   action_on:
     description: When the action happened.

packages/spec/specs/components/collection.yaml

@@ -25,7 +25,7 @@ properties:
         example: null
         nullable: true
       display_template:
-        description:
+        description: Text representation of how items from this collection are shown across the system.
         type: string
         example: null
         nullable: true

packages/spec/specs/components/setting.yaml

@@ -52,12 +52,12 @@ properties:
     example: null
     nullable: true
   storage_asset_transform:
-    description:
+    description: ""
     type: string
     example: "all"
     nullable: true
   storage_asset_presets:
-    description:
+    description: ""
     type: string
     example: null
     nullable: true

packages/spec/specs/components/user.yaml

@@ -35,12 +35,14 @@ properties:
     description: The user's description.
     example: null
     type: string
-    nullable:
+    nullable: true
   tags:
     description: The user's tags.
     example: null
     type: array
     nullable: true
+    items:
+      type: string
   avatar:
     description: The user's avatar.
     example: null

packages/spec/specs/paths/assets/assets.yaml

@@ -6,9 +6,9 @@ get:
   security:
     - Auth: []
   parameters:
-    - name: key
+    - name: id
       in: path
-      description: private_hash of the file
+      description: The id of the file.
       required: true
       schema:
         type: string