From 778289efbda3067cb521efc8795dee99888d1bbb Mon Sep 17 00:00:00 2001
From: Mike Storey <mike@agile-learning.institute>
Date: Fri, 11 Jul 2025 17:39:51 -0400
Subject: [PATCH] Fix OpenAPI schema issues for API explorer

- Fix file schema to use 'file_name' instead of 'name' to match actual API responses
- Fix dictionary schema circular reference by using additionalProperties instead of properties
- Remove PATCH endpoints for test_data and migrations from spec (these don't exist in API)
- All schema definitions now match actual API responses
- YAML syntax is valid and spec loads without errors
---
 docs/openapi.yaml | 43 +++++--------------------------------------
 1 file changed, 5 insertions(+), 38 deletions(-)

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 367736e..6cda38f 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -522,24 +522,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/events'
-    patch:
-      summary: Lock all Test Data Files
-      operationId: lock_all_test_data
-      tags:
-        - Test Data
-      responses:
-        '200':
-          description: All test data files locked successfully
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/events'
-        '500':
-          description: Processing error
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/events'
+
 
   /api/test_data/{file_name}/:
     get:
@@ -650,24 +633,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/events'
-    patch:
-      summary: Lock all Migration Files
-      operationId: lock_all_migrations
-      tags:
-        - Migrations
-      responses:
-        '200':
-          description: All migration files locked successfully
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/events'
-        '500':
-          description: Processing error
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/events'
+
 
 
   /api/migrations/{file_name}/:
@@ -954,8 +920,9 @@ components:
     file:
       type: object
       properties:
-        name:
+        file_name:
           type: string
+          description: Name of the file
         created_at:
           type: string
           format: date-time
@@ -1065,7 +1032,7 @@ components:
         properties:
           description: Properties of an Object type
           type: object
-          properties:
+          additionalProperties:
             $ref: '#/components/schemas/dictionary'
         additionalProperties:
           description: Should the object type allow additional properties