fix: update spec generation to align with reality

src/swagger/api-spec/openapi.json

@@ -872,7 +872,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/APIReferenceList"
+                  "$ref": "#/components/schemas/ClassSpellList"
                 },
                 "example": {
                   "count": 2,
@@ -6161,6 +6161,39 @@
             }
           }
         ]
+      },
+      "ClassLevelSpell": {
+        "description": "`ClassLevelSpell`\n",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/APIReference"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "level": {
+                "type": "number",
+                "description": "The level of the spell slot used to cast the spell."
+              }
+            }
+          }
+        ]
+      },
+      "ClassSpellList": {
+        "description": "`ClassSpellList`\n",
+        "type": "object",
+        "properties": {
+          "count": {
+            "description": "Total number of resources available.",
+            "type": "number"
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ClassLevelSpell"
+            }
+          }
+        }
       }
     }
   }

src/swagger/api-spec/openapi.yml

@@ -553,7 +553,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/APIReferenceList'
+                $ref: '#/components/schemas/ClassSpellList'
               example:
                 count: 2
                 results:
@@ -4165,3 +4165,25 @@ components:
             notes:
               description: Information regarding the damage.
               type: string
+    ClassLevelSpell:
+      description: |
+        `ClassLevelSpell`
+      allOf:
+        - $ref: '#/components/schemas/APIReference'
+        - type: object
+          properties:
+            level:
+              type: number
+              description: The level of the spell slot used to cast the spell.
+    ClassSpellList:
+      description: |
+        `ClassSpellList`
+      type: object
+      properties:
+        count:
+          description: Total number of resources available.
+          type: number
+        results:
+          type: array
+          items:
+            $ref: '#/components/schemas/ClassLevelSpell'

src/swagger/paths/classes.yml

@@ -201,7 +201,7 @@ class-spells-path:
         content:
           application/json:
             schema:
-              $ref: '../schemas/combined.yml#/APIReferenceList'
+              $ref: '../schemas/combined.yml#/ClassSpellList'
             example:
               count: 2
               results:

src/swagger/schemas/classes.yml

@@ -250,3 +250,26 @@ class-level-model:
         - $ref: '#/cs-sorcerer'
         - $ref: '#/cs-warlock'
         - $ref: '#/cs-wizard'
+class-level-spell-model:
+  description: |
+    `ClassLevelSpell`
+  allOf:
+    - $ref: './combined.yml#/APIReference'
+    - type: object
+      properties:
+        level:
+          type: number
+          description: 'The level of the spell slot used to cast the spell.'
+
+class-spell-list-model:
+  description: |
+    `ClassSpellList`
+  type: object
+  properties:
+    count:
+      description: 'Total number of resources available.'
+      type: number
+    results:
+      type: array
+      items:
+        $ref: '#/class-level-spell-model'

src/swagger/schemas/combined.yml

@@ -118,3 +118,7 @@ OptionSet:
   $ref: './common.yml#/option-set-model'
 Option:
   $ref: './common.yml#/option-model'
+ClassLevelSpell:
+  $ref: './classes.yml#/class-level-spell-model'
+ClassSpellList:
+  $ref: './classes.yml#/class-spell-list-model'

src/swagger/schemas/subclass.yml

@@ -36,6 +36,7 @@ subclass-model:
                   $ref: "./combined.yml#/SpellPrerequisite"
               spell:
                 $ref: "./combined.yml#/APIReference"
+
 subclass-level-resource-model:
   type: object
   properties: