api/src/main/java/org/apache/custos/api/group/GroupManagementController.java [194:258]:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            requestBody = @io.swagger.v3.oas.annotations.parameters.RequestBody(
                    required = true,
                    content = @Content(
                            schemaProperties = {
                                    @SchemaProperty(
                                            name = "name",
                                            schema = @Schema(
                                                    type = "string",
                                                    description = "Group Name"
                                            )
                                    ),
                                    @SchemaProperty(
                                            name = "description",
                                            schema = @Schema(
                                                    type = "string",
                                                    description = "Group Description"
                                            )
                                    ),
                                    @SchemaProperty(
                                            name = "attributes",
                                            array = @ArraySchema(
                                                    schema = @Schema(implementation = GroupAttribute.class),
                                                    arraySchema = @Schema(description = "List of Group Attributes")
                                            )
                                    ),
                                    @SchemaProperty(
                                            name = "realm_roles",
                                            array = @ArraySchema(
                                                    schema = @Schema(implementation = String.class),
                                                    arraySchema = @Schema(description = "List of Realm Roles")
                                            )
                                    ),
                                    @SchemaProperty(
                                            name = "client_roles",
                                            array = @ArraySchema(
                                                    schema = @Schema(implementation = String.class),
                                                    arraySchema = @Schema(description = "List of Client Roles")
                                            )
                                    )
                            }
                    )
            ),
            parameters = {
                    @Parameter(
                            name = "client_id",
                            in = ParameterIn.HEADER,
                            description = "The client ID initiating the group update request",
                            required = true,
                            schema = @Schema(type = "string")
                    ),
                    @Parameter(
                            name = "groupId",
                            in = ParameterIn.PATH,
                            description = "The ID of the group to update",
                            required = true,
                            schema = @Schema(type = "string")
                    )
            },
            responses = {
                    @ApiResponse(responseCode = "200", description = "Group updated successfully", content = @Content(schema = @Schema(implementation = Group.class))),
                    @ApiResponse(responseCode = "401", description = "Unauthorized Request", content = @Content()),
                    @ApiResponse(responseCode = "404", description = "When the associated Group cannot be found", content = @Content()),
                    @ApiResponse(responseCode = "500", description = "Internal Server Error", content = @Content())
            }
    )
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -



api/src/main/java/org/apache/custos/api/group/GroupManagementController.java [277:341]:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            requestBody = @io.swagger.v3.oas.annotations.parameters.RequestBody(
                    required = true,
                    content = @Content(
                            schemaProperties = {
                                    @SchemaProperty(
                                            name = "name",
                                            schema = @Schema(
                                                    type = "string",
                                                    description = "Group Name"
                                            )
                                    ),
                                    @SchemaProperty(
                                            name = "description",
                                            schema = @Schema(
                                                    type = "string",
                                                    description = "Group Description"
                                            )
                                    ),
                                    @SchemaProperty(
                                            name = "attributes",
                                            array = @ArraySchema(
                                                    schema = @Schema(implementation = GroupAttribute.class),
                                                    arraySchema = @Schema(description = "List of Group Attributes")
                                            )
                                    ),
                                    @SchemaProperty(
                                            name = "realm_roles",
                                            array = @ArraySchema(
                                                    schema = @Schema(implementation = String.class),
                                                    arraySchema = @Schema(description = "List of Realm Roles")
                                            )
                                    ),
                                    @SchemaProperty(
                                            name = "client_roles",
                                            array = @ArraySchema(
                                                    schema = @Schema(implementation = String.class),
                                                    arraySchema = @Schema(description = "List of Client Roles")
                                            )
                                    )
                            }
                    )
            ),
            parameters = {
                    @Parameter(
                            name = "client_id",
                            in = ParameterIn.HEADER,
                            description = "The client ID initiating the group update request",
                            required = true,
                            schema = @Schema(type = "string")
                    ),
                    @Parameter(
                            name = "groupId",
                            in = ParameterIn.PATH,
                            description = "The ID of the group to update",
                            required = true,
                            schema = @Schema(type = "string")
                    )
            },
            responses = {
                    @ApiResponse(responseCode = "200", description = "Group updated successfully", content = @Content(schema = @Schema(implementation = Group.class))),
                    @ApiResponse(responseCode = "401", description = "Unauthorized Request", content = @Content()),
                    @ApiResponse(responseCode = "404", description = "When the associated Group cannot be found", content = @Content()),
                    @ApiResponse(responseCode = "500", description = "Internal Server Error", content = @Content())
            }
    )
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -