chore: Add missing doc on public endpoint

Author: matiasperrone

app/Http/Controllers/Apis/Protected/Summit/OAuth2SummitsEventTypesApiController.php

@@ -96,7 +96,7 @@ public function __construct
                 in: "path",
                 required: true,
                 schema: new OA\Schema(type: "string"),
-                description: "Summit ID or slug"
+                description: "Summit ID"
             ),
             new OA\Parameter(
                 name: "page",
@@ -230,7 +230,7 @@ function ($page, $per_page, $filter, $order, $applyExtraFilters) use ($summit) {
                 in: "path",
                 required: true,
                 schema: new OA\Schema(type: "string"),
-                description: "Summit ID or slug"
+                description: "Summit ID"
             ),
             new OA\Parameter(
                 name: "page",
@@ -403,14 +403,52 @@ public function getAllBySummitCSV($summit_id)
         path: "/api/v1/summits/{id}/event-types/{event_type_id}",
         operationId: "getEventTypeBySummit",
         description: "Get a specific event type by ID",
+        tags: ["Event Types"],
+        parameters: [
+            new OA\Parameter(
+                name: "id",
+                in: "path",
+                required: true,
+                schema: new OA\Schema(type: "string"),
+                description: "Summit ID"
+            ),
+            new OA\Parameter(
+                name: "event_type_id",
+                in: "path",
+                required: true,
+                schema: new OA\Schema(type: "integer", format: "int64"),
+                description: "Event type ID"
+            ),
+            new OA\Parameter(
+                name: "expand",
+                in: "query",
+                required: false,
+                schema: new OA\Schema(type: "string"),
+                description: "Expand relationships"
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: Response::HTTP_OK,
+                description: "Event type retrieved successfully",
+                content: new OA\JsonContent(ref: "#/components/schemas/EventType")
+            ),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Event type or summit not found"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
+    #[OA\Get(
+        path: "/api/public/v1/summits/{id}/event-types/{event_type_id}",
+        operationId: "getEventTypeBySummitPublic",
+        description: "Get a specific event type by ID",
         tags: ["Event Types (Public)"],
         parameters: [
             new OA\Parameter(
                 name: "id",
                 in: "path",
                 required: true,
                 schema: new OA\Schema(type: "string"),
-                description: "Summit ID or slug"
+                description: "Summit ID"
             ),
             new OA\Parameter(
                 name: "event_type_id",
@@ -484,7 +522,7 @@ public function getEventTypeBySummit($summit_id, $event_type_id)
                 in: "path",
                 required: true,
                 schema: new OA\Schema(type: "string"),
-                description: "Summit ID or slug"
+                description: "Summit ID"
             ),
         ],
         requestBody: new OA\RequestBody(
@@ -549,7 +587,7 @@ public function addEventTypeBySummit($summit_id)
                 in: "path",
                 required: true,
                 schema: new OA\Schema(type: "string"),
-                description: "Summit ID or slug"
+                description: "Summit ID"
             ),
             new OA\Parameter(
                 name: "event_type_id",
@@ -621,7 +659,7 @@ public function updateEventTypeBySummit($summit_id, $event_type_id)
                 in: "path",
                 required: true,
                 schema: new OA\Schema(type: "string"),
-                description: "Summit ID or slug"
+                description: "Summit ID"
             ),
             new OA\Parameter(
                 name: "event_type_id",
@@ -680,7 +718,7 @@ public function deleteEventTypeBySummit($summit_id, $event_type_id)
                 in: "path",
                 required: true,
                 schema: new OA\Schema(type: "string"),
-                description: "Summit ID or slug"
+                description: "Summit ID"
             ),
         ],
         responses: [
@@ -744,7 +782,7 @@ public function seedDefaultEventTypesBySummit($summit_id)
                 in: "path",
                 required: true,
                 schema: new OA\Schema(type: "string"),
-                description: "Summit ID or slug"
+                description: "Summit ID"
             ),
             new OA\Parameter(
                 name: "event_type_id",
@@ -829,7 +867,7 @@ public function addSummitDocument($summit_id, $event_type_id, $document_id)
                 in: "path",
                 required: true,
                 schema: new OA\Schema(type: "string"),
-                description: "Summit ID or slug"
+                description: "Summit ID"
             ),
             new OA\Parameter(
                 name: "event_type_id",

app/Swagger/Models/EventTypeSchema.php

@@ -1,4 +1,4 @@
-<?php 
+<?php
 namespace App\Swagger\schemas;
 
 use OpenApi\Attributes as OA;
@@ -29,15 +29,13 @@
         new OA\Property(
             property: "color",
             type: "string",
-            nullable: true,
             description: "Display color (hex)",
             example: "#FF5733"
         ),
         new OA\Property(
             property: "black_out_times",
             type: "string",
             enum: ["UNLIMITED", "ONLY_MAIN_EVENTS", "BLACKOUT_TIMES"],
-            nullable: true,
             description: "Blackout times setting",
             example: "UNLIMITED"
         ),
@@ -107,33 +105,27 @@ enum: ["UNLIMITED", "ONLY_MAIN_EVENTS", "BLACKOUT_TIMES"],
             type: "array",
             description: "Summit document IDs (use expand=summit_documents to get full objects)",
             items: new OA\Items(
-                anyOf: [
+                oneOf: [
                     new OA\Schema(type: "integer"),
                     new OA\Schema(ref: "#/components/schemas/SummitDocument")
                 ]
-            ),
-            nullable: true
+            )
         ),
         new OA\Property(
             property: "allowed_ticket_types",
             type: "array",
             description: "Allowed ticket type IDs (use expand=allowed_ticket_types to get full objects)",
             items: new OA\Items(
-                anyOf: [
+                oneOf: [
                     new OA\Schema(type: "integer"),
                     new OA\Schema(ref: "#/components/schemas/SummitTicketType")
                 ]
-            ),
-            nullable: true
+            )
         ),
         new OA\Property(
             property: "summit",
             description: "Summit ID or expanded object (use expand=summit to get full object)",
-            anyOf: [
-                new OA\Schema(type: "integer"),
-                new OA\Schema(ref: "#/components/schemas/Summit")
-            ],
-            nullable: true
+            schema: "#/components/schemas/Summit",
         ),
         new OA\Property(
             property: "created",