From 761b205ed02f3552913a7fff80bc32ddd761440f Mon Sep 17 00:00:00 2001 From: juancarmore Date: Thu, 19 Feb 2026 10:22:29 +0100 Subject: [PATCH] openapi: add sort field parameters for users, recordings, room members, and rooms --- .../parameters/internal/user-sort-field.yaml | 9 +++++++++ .../components/parameters/recording-sort-field.yaml | 11 +++++++++++ .../components/parameters/room-member-sort-field.yaml | 9 +++++++++ .../{sort-field.yaml => room-sort-field.yaml} | 2 +- meet-ce/backend/openapi/paths/internal/users.yaml | 2 +- meet-ce/backend/openapi/paths/recordings.yaml | 2 +- meet-ce/backend/openapi/paths/room-members.yaml | 2 +- meet-ce/backend/openapi/paths/rooms.yaml | 2 +- 8 files changed, 34 insertions(+), 5 deletions(-) create mode 100644 meet-ce/backend/openapi/components/parameters/internal/user-sort-field.yaml create mode 100644 meet-ce/backend/openapi/components/parameters/recording-sort-field.yaml create mode 100644 meet-ce/backend/openapi/components/parameters/room-member-sort-field.yaml rename meet-ce/backend/openapi/components/parameters/{sort-field.yaml => room-sort-field.yaml} (71%) diff --git a/meet-ce/backend/openapi/components/parameters/internal/user-sort-field.yaml b/meet-ce/backend/openapi/components/parameters/internal/user-sort-field.yaml new file mode 100644 index 00000000..4448f98b --- /dev/null +++ b/meet-ce/backend/openapi/components/parameters/internal/user-sort-field.yaml @@ -0,0 +1,9 @@ +name: sortField +in: query +required: false +description: The user field by which to sort the results. +schema: + type: string + enum: + - name + - registrationDate diff --git a/meet-ce/backend/openapi/components/parameters/recording-sort-field.yaml b/meet-ce/backend/openapi/components/parameters/recording-sort-field.yaml new file mode 100644 index 00000000..be6e5a43 --- /dev/null +++ b/meet-ce/backend/openapi/components/parameters/recording-sort-field.yaml @@ -0,0 +1,11 @@ +name: sortField +in: query +required: false +description: The recording field by which to sort the results. +schema: + type: string + enum: + - startDate + - roomName + - duration + - size diff --git a/meet-ce/backend/openapi/components/parameters/room-member-sort-field.yaml b/meet-ce/backend/openapi/components/parameters/room-member-sort-field.yaml new file mode 100644 index 00000000..29cca4fe --- /dev/null +++ b/meet-ce/backend/openapi/components/parameters/room-member-sort-field.yaml @@ -0,0 +1,9 @@ +name: sortField +in: query +required: false +description: The room member field by which to sort the results. +schema: + type: string + enum: + - name + - membershipDate diff --git a/meet-ce/backend/openapi/components/parameters/sort-field.yaml b/meet-ce/backend/openapi/components/parameters/room-sort-field.yaml similarity index 71% rename from meet-ce/backend/openapi/components/parameters/sort-field.yaml rename to meet-ce/backend/openapi/components/parameters/room-sort-field.yaml index d38d94ae..e67ed5b8 100644 --- a/meet-ce/backend/openapi/components/parameters/sort-field.yaml +++ b/meet-ce/backend/openapi/components/parameters/room-sort-field.yaml @@ -1,7 +1,7 @@ name: sortField in: query required: false -description: The field by which to sort the results. +description: The room field by which to sort the results. schema: type: string enum: diff --git a/meet-ce/backend/openapi/paths/internal/users.yaml b/meet-ce/backend/openapi/paths/internal/users.yaml index 6aae30c9..79e8b577 100644 --- a/meet-ce/backend/openapi/paths/internal/users.yaml +++ b/meet-ce/backend/openapi/paths/internal/users.yaml @@ -43,7 +43,7 @@ - $ref: '../../components/parameters/internal/user-role.yaml' - $ref: '../../components/parameters/max-items.yaml' - $ref: '../../components/parameters/next-page-token.yaml' - - $ref: '../../components/parameters/sort-field.yaml' + - $ref: '../../components/parameters/internal/user-sort-field.yaml' - $ref: '../../components/parameters/sort-order.yaml' responses: '200': diff --git a/meet-ce/backend/openapi/paths/recordings.yaml b/meet-ce/backend/openapi/paths/recordings.yaml index f35c4ed0..c09eef4d 100644 --- a/meet-ce/backend/openapi/paths/recordings.yaml +++ b/meet-ce/backend/openapi/paths/recordings.yaml @@ -65,7 +65,7 @@ - $ref: '../components/parameters/recording-fields.yaml' - $ref: '../components/parameters/max-items.yaml' - $ref: '../components/parameters/next-page-token.yaml' - - $ref: '../components/parameters/sort-field.yaml' + - $ref: '../components/parameters/recording-sort-field.yaml' - $ref: '../components/parameters/sort-order.yaml' responses: '200': diff --git a/meet-ce/backend/openapi/paths/room-members.yaml b/meet-ce/backend/openapi/paths/room-members.yaml index 20cd046b..8c2efda3 100644 --- a/meet-ce/backend/openapi/paths/room-members.yaml +++ b/meet-ce/backend/openapi/paths/room-members.yaml @@ -52,7 +52,7 @@ - $ref: '../components/parameters/room-member-fields.yaml' - $ref: '../components/parameters/max-items.yaml' - $ref: '../components/parameters/next-page-token.yaml' - - $ref: '../components/parameters/sort-field.yaml' + - $ref: '../components/parameters/room-member-sort-field.yaml' - $ref: '../components/parameters/sort-order.yaml' responses: '200': diff --git a/meet-ce/backend/openapi/paths/rooms.yaml b/meet-ce/backend/openapi/paths/rooms.yaml index e68753c6..bd3219ff 100644 --- a/meet-ce/backend/openapi/paths/rooms.yaml +++ b/meet-ce/backend/openapi/paths/rooms.yaml @@ -47,7 +47,7 @@ - $ref: '../components/parameters/extraFields.yaml' - $ref: '../components/parameters/max-items.yaml' - $ref: '../components/parameters/next-page-token.yaml' - - $ref: '../components/parameters/sort-field.yaml' + - $ref: '../components/parameters/room-sort-field.yaml' - $ref: '../components/parameters/sort-order.yaml' responses: '200':