From f17fea9c64aadf9385d107611c9c4f2a2f9f1e84 Mon Sep 17 00:00:00 2001
From: Jose Andres Tejerina <andres.tejerina@exomindset.co>
Date: Fri, 21 Nov 2025 15:53:34 -0300
Subject: [PATCH] feat: Extend Swagger Coverage for controller
 OAuth2SummitBookableRoomsAttributeTypeApiController

---
 ...ookableRoomsAttributeTypeApiController.php | 632 ++++++++++++++++++
 ...ummitBookableRoomsAttributeTypeSchemas.php |  81 +++
 .../SummitLocationsAttributeTypesSchemas.php  |  48 ++
 .../SummitLocationsAttributeValuesSchemas.php |  39 ++
 ...mmitBookableRoomsAttributeTypeSecurity.php |  25 +
 5 files changed, 825 insertions(+)
 create mode 100644 app/Swagger/SummitBookableRoomsAttributeTypeSchemas.php
 create mode 100644 app/Swagger/SummitLocationsAttributeTypesSchemas.php
 create mode 100644 app/Swagger/SummitLocationsAttributeValuesSchemas.php
 create mode 100644 app/Swagger/security/SummitBookableRoomsAttributeTypeSecurity.php

diff --git a/app/Http/Controllers/Apis/Protected/Summit/OAuth2SummitBookableRoomsAttributeTypeApiController.php b/app/Http/Controllers/Apis/Protected/Summit/OAuth2SummitBookableRoomsAttributeTypeApiController.php
index f1fcaaf4f..79a16abac 100644
--- a/app/Http/Controllers/Apis/Protected/Summit/OAuth2SummitBookableRoomsAttributeTypeApiController.php
+++ b/app/Http/Controllers/Apis/Protected/Summit/OAuth2SummitBookableRoomsAttributeTypeApiController.php
@@ -30,6 +30,10 @@
 use utils\OrderParser;
 use utils\PagingInfo;
 use Exception;
+use App\Security\SummitScopes;
+use App\Models\Foundation\Main\IGroup;
+use Illuminate\Http\Response;
+use OpenApi\Attributes as OA;
 /**
  * Class OAuth2SummitBookableRoomsAttributeTypeApiController
  * @package App\Http\Controllers
@@ -80,6 +84,86 @@ public function __construct
         $this->summit_service             = $summit_service;
     }
 
+    #[OA\Get(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types",
+        description: "Get all bookable room attribute types for a summit",
+        summary: 'Get all bookable room attribute types',
+        operationId: 'getAllBookableRoomAttributeTypes',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::ReadSummitData,
+            SummitScopes::ReadAllSummitData,
+        ]]],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'page',
+                in: 'query',
+                required: false,
+                schema: new OA\Schema(type: 'integer', default: 1),
+                description: 'Page number'
+            ),
+            new OA\Parameter(
+                name: 'per_page',
+                in: 'query',
+                required: false,
+                schema: new OA\Schema(type: 'integer', default: 10),
+                description: 'Items per page'
+            ),
+            new OA\Parameter(
+                name: 'filter[]',
+                in: 'query',
+                required: false,
+                description: 'Filter expressions in the format field<op>value. Operators: @@, ==, =@.',
+                style: 'form',
+                explode: true,
+                schema: new OA\Schema(
+                    type: 'array',
+                    items: new OA\Items(type: 'string', example: 'type@@Room')
+                )
+            ),
+            new OA\Parameter(
+                name: 'order',
+                in: 'query',
+                required: false,
+                description: 'Order by field(s)',
+                schema: new OA\Schema(type: 'string', example: 'id,-type')
+            ),
+            new OA\Parameter(
+                name: 'expand',
+                in: 'query',
+                required: false,
+                description: 'Comma-separated list of related resources to include',
+                schema: new OA\Schema(type: 'string', example: 'values')
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: 200,
+                description: 'Get all paginated bookable room attribute types',
+                content:  new OA\JsonContent(ref: '#/components/schemas/PaginatedBookableRoomAttributeTypesResponse')
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @return \Illuminate\Http\JsonResponse|mixed
@@ -170,6 +254,63 @@ public function getAllBookableRoomAttributeTypes($summit_id){
         }
     }
 
+    #[OA\Post(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types",
+        description: "Create a new bookable room attribute type",
+        summary: 'Create bookable room attribute type',
+        operationId: 'addBookableRoomAttributeType',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::WriteSummitData,
+        ]]],
+        x: [
+            'required-groups' => [
+                IGroup::SuperAdmins,
+                IGroup::Administrators,
+                IGroup::SummitAdministrators,
+            ]
+        ],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'expand',
+                in: 'query',
+                required: false,
+                description: 'Comma-separated list of related resources to include',
+                schema: new OA\Schema(type: 'string', example: 'values')
+            ),
+        ],
+        requestBody: new OA\RequestBody(
+            required: true,
+            content: new OA\JsonContent(ref: '#/components/schemas/BookableRoomAttributeTypeCreateRequest')
+        ),
+        responses: [
+            new OA\Response(
+                response: 201,
+                description: 'Bookable room attribute type created',
+                content: new OA\JsonContent(ref: '#/components/schemas/SummitBookableVenueRoomAttributeType')
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @return \Illuminate\Http\JsonResponse|mixed
@@ -216,6 +357,60 @@ public function addBookableRoomAttributeType($summit_id){
         }
     }
 
+    #[OA\Get(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types/{type_id}",
+        description: "Get a specific bookable room attribute type",
+        summary: 'Get bookable room attribute type',
+        operationId: 'getBookableRoomAttributeType',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::ReadSummitData,
+            SummitScopes::ReadAllSummitData,
+        ]]],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'type_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute type id'
+            ),
+            new OA\Parameter(
+                name: 'expand',
+                in: 'query',
+                required: false,
+                description: 'Comma-separated list of related resources to include',
+                schema: new OA\Schema(type: 'string', example: 'values')
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: 200,
+                description: 'Bookable room attribute type',
+                content: new OA\JsonContent(ref: '#/components/schemas/SummitBookableVenueRoomAttributeType')
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @param $type_id
@@ -246,6 +441,63 @@ public function getBookableRoomAttributeType($summit_id, $type_id){
             return $this->error500($ex);
         }
     }
+    #[OA\Put(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types/{type_id}",
+        description: "Update a bookable room attribute type",
+        summary: 'Update bookable room attribute type',
+        operationId: 'updateBookableRoomAttributeType',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::WriteSummitData,
+        ]]],
+        x: [
+            'required-groups' => [
+                IGroup::SuperAdmins,
+                IGroup::Administrators,
+                IGroup::SummitAdministrators,
+            ]
+        ],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'type_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute type id'
+            ),
+        ],
+        requestBody: new OA\RequestBody(
+            required: true,
+            content: new OA\JsonContent(ref: '#/components/schemas/BookableRoomAttributeTypeCreateRequest')
+        ),
+        responses: [
+            new OA\Response(
+                response: 200,
+                description: 'Bookable room attribute type updated',
+                content: new OA\JsonContent(ref: '#/components/schemas/SummitBookableVenueRoomAttributeType')
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @param $type_id
@@ -293,6 +545,58 @@ public function updateBookableRoomAttributeType($summit_id, $type_id){
         }
     }
 
+    #[OA\Delete(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types/{type_id}",
+        description: "Delete a bookable room attribute type",
+        summary: 'Delete bookable room attribute type',
+        operationId: 'deleteBookableRoomAttributeType',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::WriteSummitData,
+        ]]],
+        x: [
+            'required-groups' => [
+                IGroup::SuperAdmins,
+                IGroup::Administrators,
+                IGroup::SummitAdministrators,
+            ]
+        ],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'type_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute type id'
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: 204,
+                description: "Deleted"
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @param $type_id
@@ -324,6 +628,93 @@ public function deleteBookableRoomAttributeType($summit_id, $type_id){
 
     // values
 
+    #[OA\Get(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types/{type_id}/values",
+        description: "Get all values for a bookable room attribute type",
+        summary: 'Get all bookable room attribute values',
+        operationId: 'getAllBookableRoomAttributeValues',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::ReadSummitData,
+            SummitScopes::ReadAllSummitData,
+        ]]],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'type_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute type id'
+            ),
+            new OA\Parameter(
+                name: 'page',
+                in: 'query',
+                required: false,
+                schema: new OA\Schema(type: 'integer', default: 1),
+                description: 'Page number'
+            ),
+            new OA\Parameter(
+                name: 'per_page',
+                in: 'query',
+                required: false,
+                schema: new OA\Schema(type: 'integer', default: 10),
+                description: 'Items per page'
+            ),
+            new OA\Parameter(
+                name: 'filter[]',
+                in: 'query',
+                required: false,
+                description: 'Filter expressions in the format field<op>value. Operators: @@, ==, =@.',
+                style: 'form',
+                explode: true,
+                schema: new OA\Schema(
+                    type: 'array',
+                    items: new OA\Items(type: 'string', example: 'value@@Large')
+                )
+            ),
+            new OA\Parameter(
+                name: 'order',
+                in: 'query',
+                required: false,
+                description: 'Order by field(s)',
+                schema: new OA\Schema(type: 'string', example: 'id,-value')
+            ),
+            new OA\Parameter(
+                name: 'expand',
+                in: 'query',
+                required: false,
+                description: 'Comma-separated list of related resources to include',
+                schema: new OA\Schema(type: 'string', example: 'type')
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: 200,
+                description: 'Get all paginated bookable room attribute values',
+                content: new OA\JsonContent(ref: '#/components/schemas/PaginatedBookableRoomAttributeValuesResponse')
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @param $type_id
@@ -421,6 +812,67 @@ public function getAllBookableRoomAttributeValues($summit_id, $type_id){
         }
     }
 
+    #[OA\Get(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types/{type_id}/values/{value_id}",
+        description: "Get a specific bookable room attribute value",
+        summary: 'Get bookable room attribute value',
+        operationId: 'getBookableRoomAttributeValue',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::ReadSummitData,
+            SummitScopes::ReadAllSummitData,
+        ]]],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'type_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute type id'
+            ),
+            new OA\Parameter(
+                name: 'value_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute value id'
+            ),
+            new OA\Parameter(
+                name: 'expand',
+                in: 'query',
+                required: false,
+                description: 'Comma-separated list of related resources to include',
+                schema: new OA\Schema(type: 'string', example: 'type')
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: 200,
+                description: 'Bookable room attribute value',
+                content: new OA\JsonContent(ref: '#/components/schemas/SummitBookableVenueRoomAttributeValue')
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @param $type_id
@@ -456,6 +908,63 @@ public function getBookableRoomAttributeValue($summit_id, $type_id, $value_id){
         }
     }
 
+    #[OA\Post(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types/{type_id}/values",
+        description: "Create a new bookable room attribute value",
+        summary: 'Create bookable room attribute value',
+        operationId: 'addBookableRoomAttributeValue',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::WriteSummitData,
+        ]]],
+        x: [
+            'required-groups' => [
+                IGroup::SuperAdmins,
+                IGroup::Administrators,
+                IGroup::SummitAdministrators,
+            ]
+        ],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'type_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute type id'
+            ),
+        ],
+        requestBody: new OA\RequestBody(
+            required: true,
+            content: new OA\JsonContent(ref: '#/components/schemas/BookableRoomAttributeValueCreateRequest')
+        ),
+        responses: [
+            new OA\Response(
+                response: 201,
+                description: 'Bookable room attribute value created',
+                content: new OA\JsonContent(ref: '#/components/schemas/SummitBookableVenueRoomAttributeValue')
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @param $type_id
@@ -503,6 +1012,70 @@ public function addBookableRoomAttributeValue($summit_id, $type_id){
         }
     }
 
+    #[OA\Put(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types/{type_id}/values/{value_id}",
+        description: "Update a bookable room attribute value",
+        summary: 'Update bookable room attribute value',
+        operationId: 'updateBookableRoomAttributeValue',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::WriteSummitData,
+        ]]],
+        x: [
+            'required-groups' => [
+                IGroup::SuperAdmins,
+                IGroup::Administrators,
+                IGroup::SummitAdministrators,
+            ]
+        ],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'type_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute type id'
+            ),
+            new OA\Parameter(
+                name: 'value_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute value id'
+            ),
+        ],
+        requestBody: new OA\RequestBody(
+            required: true,
+            content: new OA\JsonContent(ref: '#/components/schemas/BookableRoomAttributeValueCreateRequest')
+        ),
+        responses: [
+            new OA\Response(
+                response: 200,
+                description: 'Bookable room attribute value updated',
+                content: new OA\JsonContent(ref: '#/components/schemas/SummitBookableVenueRoomAttributeValue')
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @param $type_id
@@ -551,6 +1124,65 @@ public function updateBookableRoomAttributeValue($summit_id, $type_id, $value_id
         }
     }
 
+    #[OA\Delete(
+        path: "/api/v1/summits/{id}/bookable-room-attribute-types/{type_id}/values/{value_id}",
+        description: "Delete a bookable room attribute value",
+        summary: 'Delete bookable room attribute value',
+        operationId: 'deleteBookableRoomAttributeValue',
+        tags: ['Bookable Room Attributes'],
+        security: [['summit_bookable_rooms_attribute_oauth2' => [
+            SummitScopes::WriteSummitData,
+        ]]],
+        x: [
+            'required-groups' => [
+                IGroup::SuperAdmins,
+                IGroup::Administrators,
+                IGroup::SummitAdministrators,
+            ]
+        ],
+        parameters: [
+            new OA\Parameter(
+                name: 'access_token',
+                in: 'query',
+                required: false,
+                description: 'OAuth2 access token (alternative to Authorization: Bearer)',
+                schema: new OA\Schema(type: 'string', example: 'eyJhbGciOi...'),
+            ),
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'type_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute type id'
+            ),
+            new OA\Parameter(
+                name: 'value_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The attribute value id'
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: 204,
+                description: "Deleted"
+            ),
+            new OA\Response(response: Response::HTTP_BAD_REQUEST, description: "Bad Request"),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_FORBIDDEN, description: "Forbidden"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not found"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+        ]
+    )]
     /**
      * @param $summit_id
      * @param $type_id
diff --git a/app/Swagger/SummitBookableRoomsAttributeTypeSchemas.php b/app/Swagger/SummitBookableRoomsAttributeTypeSchemas.php
new file mode 100644
index 000000000..ecbcef54c
--- /dev/null
+++ b/app/Swagger/SummitBookableRoomsAttributeTypeSchemas.php
@@ -0,0 +1,81 @@
+<?php
+namespace App\Swagger\schemas;
+
+use OpenApi\Attributes as OA;
+
+/**
+ * Summit Bookable Rooms Attribute Type Request/Response Schemas
+ * Schemas for API requests and paginated responses
+ */
+
+#[OA\Schema(
+    schema: 'BookableRoomAttributeTypeCreateRequest',
+    type: 'object',
+    required: ['type'],
+    properties: [
+        new OA\Property(
+            property: 'type',
+            type: 'string',
+            example: 'Room Size',
+            description: 'The attribute type name'
+        ),
+    ]
+)]
+class BookableRoomAttributeTypeCreateRequestSchema {}
+
+#[OA\Schema(
+    schema: 'BookableRoomAttributeValueCreateRequest',
+    type: 'object',
+    required: ['value'],
+    properties: [
+        new OA\Property(
+            property: 'value',
+            type: 'string',
+            example: 'Large',
+            description: 'The attribute value'
+        ),
+    ]
+)]
+class BookableRoomAttributeValueCreateRequestSchema {}
+
+#[OA\Schema(
+    schema: 'PaginatedBookableRoomAttributeTypesResponse',
+    type: 'object',
+    description: 'Paginated response containing bookable room attribute types',
+    allOf: [
+        new OA\Schema(ref: '#/components/schemas/PaginateDataSchemaResponse'),
+        new OA\Schema(
+            type: 'object',
+            properties: [
+                new OA\Property(
+                    property: 'data',
+                    type: 'array',
+                    items: new OA\Items(ref: '#/components/schemas/SummitBookableVenueRoomAttributeTypeExpanded'),
+                    description: 'Array of bookable room attribute types'
+                )
+            ]
+        )
+    ]
+)]
+class PaginatedBookableRoomAttributeTypesResponseSchema {}
+
+#[OA\Schema(
+    schema: 'PaginatedBookableRoomAttributeValuesResponse',
+    type: 'object',
+    description: 'Paginated response containing bookable room attribute values',
+    allOf: [
+        new OA\Schema(ref: '#/components/schemas/PaginateDataSchemaResponse'),
+        new OA\Schema(
+            type: 'object',
+            properties: [
+                new OA\Property(
+                    property: 'data',
+                    type: 'array',
+                    items: new OA\Items(ref: '#/components/schemas/SummitBookableVenueRoomAttributeValueExpanded'),
+                    description: 'Array of bookable room attribute values'
+                )
+            ]
+        )
+    ]
+)]
+class PaginatedBookableRoomAttributeValuesResponseSchema {}
diff --git a/app/Swagger/SummitLocationsAttributeTypesSchemas.php b/app/Swagger/SummitLocationsAttributeTypesSchemas.php
new file mode 100644
index 000000000..64533f519
--- /dev/null
+++ b/app/Swagger/SummitLocationsAttributeTypesSchemas.php
@@ -0,0 +1,48 @@
+<?php
+namespace App\Swagger\schemas;
+
+use OpenApi\Attributes as OA;
+
+/**
+ * Summit Bookable Venue Room Attribute Type Schemas
+ * Schemas for SummitBookableVenueRoomAttributeType entities
+ */
+
+#[OA\Schema(
+    schema: 'SummitBookableVenueRoomAttributeType',
+    type: 'object',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer', example: 1, description: 'Attribute type ID'),
+        new OA\Property(property: 'created', type: 'integer', example: 1630500518, description: 'Creation timestamp (Unix)'),
+        new OA\Property(property: 'last_edited', type: 'integer', example: 1630500518, description: 'Last edit timestamp (Unix)'),
+        new OA\Property(property: 'type', type: 'string', example: 'Room Size', description: 'The attribute type name'),
+        new OA\Property(property: 'summit_id', type: 'integer', example: 1, description: 'Associated summit ID'),
+        new OA\Property(
+            property: 'values',
+            type: 'array',
+            items: new OA\Items(type: 'integer', example: 1),
+            example: [1, 2, 3],
+            description: 'List of attribute value IDs'
+        ),
+    ]
+)]
+class SummitBookableVenueRoomAttributeTypeSchema {}
+
+#[OA\Schema(
+    schema: 'SummitBookableVenueRoomAttributeTypeExpanded',
+    type: 'object',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer', example: 1, description: 'Attribute type ID'),
+        new OA\Property(property: 'created', type: 'integer', example: 1630500518, description: 'Creation timestamp (Unix)'),
+        new OA\Property(property: 'last_edited', type: 'integer', example: 1630500518, description: 'Last edit timestamp (Unix)'),
+        new OA\Property(property: 'type', type: 'string', example: 'Room Size', description: 'The attribute type name'),
+        new OA\Property(property: 'summit_id', type: 'integer', example: 1, description: 'Associated summit ID'),
+        new OA\Property(
+            property: 'values',
+            type: 'array',
+            items: new OA\Items(ref: '#/components/schemas/SummitBookableVenueRoomAttributeValue'),
+            description: 'Expanded list of attribute values'
+        ),
+    ]
+)]
+class SummitBookableVenueRoomAttributeTypeExpandedSchema {}
diff --git a/app/Swagger/SummitLocationsAttributeValuesSchemas.php b/app/Swagger/SummitLocationsAttributeValuesSchemas.php
new file mode 100644
index 000000000..0f0bb8bcc
--- /dev/null
+++ b/app/Swagger/SummitLocationsAttributeValuesSchemas.php
@@ -0,0 +1,39 @@
+<?php
+namespace App\Swagger\schemas;
+
+use OpenApi\Attributes as OA;
+
+/**
+ * Summit Bookable Venue Room Attribute Value Schemas
+ * Schemas for SummitBookableVenueRoomAttributeValue entities
+ */
+
+#[OA\Schema(
+    schema: 'SummitBookableVenueRoomAttributeValue',
+    type: 'object',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer', example: 1, description: 'Attribute value ID'),
+        new OA\Property(property: 'created', type: 'integer', example: 1630500518, description: 'Creation timestamp (Unix)'),
+        new OA\Property(property: 'last_edited', type: 'integer', example: 1630500518, description: 'Last edit timestamp (Unix)'),
+        new OA\Property(property: 'value', type: 'string', example: 'Large', description: 'The attribute value text'),
+        new OA\Property(property: 'type_id', type: 'integer', example: 1, description: 'Associated attribute type ID'),
+    ]
+)]
+class SummitBookableVenueRoomAttributeValueSchema {}
+
+#[OA\Schema(
+    schema: 'SummitBookableVenueRoomAttributeValueExpanded',
+    type: 'object',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer', example: 1, description: 'Attribute value ID'),
+        new OA\Property(property: 'created', type: 'integer', example: 1630500518, description: 'Creation timestamp (Unix)'),
+        new OA\Property(property: 'last_edited', type: 'integer', example: 1630500518, description: 'Last edit timestamp (Unix)'),
+        new OA\Property(property: 'value', type: 'string', example: 'Large', description: 'The attribute value text'),
+        new OA\Property(
+            property: 'type',
+            ref: '#/components/schemas/SummitBookableVenueRoomAttributeType',
+            description: 'Expanded attribute type object'
+        ),
+    ]
+)]
+class SummitBookableVenueRoomAttributeValueExpandedSchema {}
diff --git a/app/Swagger/security/SummitBookableRoomsAttributeTypeSecurity.php b/app/Swagger/security/SummitBookableRoomsAttributeTypeSecurity.php
new file mode 100644
index 000000000..8b3ad5e8c
--- /dev/null
+++ b/app/Swagger/security/SummitBookableRoomsAttributeTypeSecurity.php
@@ -0,0 +1,25 @@
+<?php 
+namespace App\Swagger\schemas;
+
+use App\Security\SummitScopes;
+use OpenApi\Attributes as OA;
+
+#[
+    OA\SecurityScheme(
+        type: 'oauth2',
+        securityScheme: 'summit_bookable_rooms_attribute_oauth2',
+        flows: [
+            new OA\Flow(
+                authorizationUrl: L5_SWAGGER_CONST_AUTH_URL,
+                tokenUrl: L5_SWAGGER_CONST_TOKEN_URL,
+                flow: 'authorizationCode',
+                scopes: [
+                    SummitScopes::ReadSummitData => 'Read Summit Data',
+                    SummitScopes::ReadAllSummitData => 'Read All Summit Data',
+                    SummitScopes::WriteSummitData => 'Write Summit Data',
+                ],
+            ),
+        ],
+    )
+]
+class SummitBookableRoomsAttributeTypeAuthSchema{}