@xen-orchestra/rest-api 0.12.0 → 0.13.1

package/open-api/spec/swagger.json

@@ -1465,6 +1465,135 @@
 					"days"
 				]
 			},
+			"Partial_Unbrand_XoAlarm__": {
+				"properties": {
+					"$pool": {
+						"type": "string"
+					},
+					"$poolId": {
+						"type": "string",
+						"deprecated": true
+					},
+					"_xapiRef": {
+						"type": "string"
+					},
+					"uuid": {
+						"type": "string"
+					},
+					"id": {
+						"type": "string"
+					},
+					"type": {
+						"type": "string",
+						"enum": [
+							"message"
+						]
+					},
+					"name": {
+						"type": "string"
+					},
+					"time": {
+						"type": "number",
+						"format": "double"
+					},
+					"body": {
+						"properties": {
+							"name": {
+								"type": "string"
+							},
+							"value": {
+								"type": "string"
+							}
+						},
+						"required": [
+							"name"
+						],
+						"type": "object"
+					},
+					"object": {
+						"properties": {
+							"href": {
+								"type": "string"
+							},
+							"uuid": {
+								"type": "string"
+							},
+							"type": {
+								"type": "string",
+								"enum": [
+									"pool",
+									"VBD",
+									"host",
+									"VIF",
+									"VTPM",
+									"VM",
+									"VM-snapshot",
+									"SR",
+									"message",
+									"vgpu",
+									"gpuGroup",
+									"network",
+									"PCI",
+									"PGPU",
+									"PIF",
+									"VDI",
+									"VDI-snapshot",
+									"VDI-unmanaged",
+									"vgpuType",
+									"VM-controller",
+									"VM-template",
+									"SM",
+									"unknown"
+								]
+							}
+						},
+						"required": [
+							"uuid",
+							"type"
+						],
+						"type": "object"
+					}
+				},
+				"type": "object",
+				"description": "Make all properties in T optional"
+			},
+			"WithHref_Partial_Unbrand_XoAlarm___": {
+				"allOf": [
+					{
+						"$ref": "#/components/schemas/Partial_Unbrand_XoAlarm__"
+					},
+					{
+						"properties": {
+							"href": {
+								"type": "string"
+							}
+						},
+						"required": [
+							"href"
+						],
+						"type": "object"
+					}
+				]
+			},
+			"SendObjects_Partial_Unbrand_XoAlarm___": {
+				"anyOf": [
+					{
+						"items": {
+							"type": "string"
+						},
+						"type": "array"
+					},
+					{
+						"items": {
+							"$ref": "#/components/schemas/WithHref_Partial_Unbrand_XoAlarm___"
+						},
+						"type": "array"
+					},
+					{
+						"$ref": "#/components/schemas/NdjsonStream"
+					}
+				]
+			},
 			"Partial_Unbrand_XoVmTemplate__": {
 				"properties": {
 					"$pool": {
@@ -2329,7 +2458,7 @@
 				],
 				"type": "object"
 			},
-			"Partial_Unbrand_XoAlarm__": {
+			"Partial_Unbrand_XoVmSnapshot__": {
 				"properties": {
 					"$pool": {
 						"type": "string"
@@ -2344,185 +2473,56 @@
 					"uuid": {
 						"type": "string"
 					},
-					"id": {
-						"type": "string"
+					"$VBDs": {
+						"items": {
+							"type": "string"
+						},
+						"type": "array"
 					},
-					"type": {
-						"type": "string",
-						"enum": [
-							"message"
-						]
+					"$VGPUs": {
+						"items": {
+							"type": "string"
+						},
+						"type": "array"
 					},
-					"name": {
+					"$container": {
 						"type": "string"
 					},
-					"time": {
-						"type": "number",
-						"format": "double"
-					},
-					"body": {
+					"CPUs": {
 						"properties": {
-							"name": {
-								"type": "string"
+							"number": {
+								"type": "number",
+								"format": "double"
 							},
-							"value": {
-								"type": "string"
+							"max": {
+								"type": "number",
+								"format": "double"
 							}
 						},
 						"required": [
-							"name"
+							"number",
+							"max"
 						],
 						"type": "object"
 					},
-					"object": {
-						"properties": {
-							"href": {
-								"type": "string"
-							},
-							"uuid": {
-								"type": "string"
-							},
-							"type": {
-								"type": "string",
-								"enum": [
-									"pool",
-									"VBD",
-									"host",
-									"VIF",
-									"VTPM",
-									"VM",
-									"VM-snapshot",
-									"SR",
-									"VM-template",
-									"message",
-									"vgpu",
-									"gpuGroup",
-									"network",
-									"PCI",
-									"PGPU",
-									"PIF",
-									"VDI",
-									"VDI-snapshot",
-									"VDI-unmanaged",
-									"vgpuType",
-									"VM-controller",
-									"SM",
-									"unknown"
-								]
-							}
-						},
-						"required": [
-							"uuid",
-							"type"
-						],
-						"type": "object"
-					}
-				},
-				"type": "object",
-				"description": "Make all properties in T optional"
-			},
-			"WithHref_Partial_Unbrand_XoAlarm___": {
-				"allOf": [
-					{
-						"$ref": "#/components/schemas/Partial_Unbrand_XoAlarm__"
+					"PV_args": {
+						"type": "string"
 					},
-					{
-						"properties": {
-							"href": {
-								"type": "string"
-							}
+					"VGPUs": {
+						"items": {
+							"type": "string"
 						},
-						"required": [
-							"href"
-						],
-						"type": "object"
-					}
-				]
-			},
-			"SendObjects_Partial_Unbrand_XoAlarm___": {
-				"anyOf": [
-					{
+						"type": "array"
+					},
+					"VIFs": {
 						"items": {
 							"type": "string"
 						},
 						"type": "array"
 					},
-					{
+					"VTPMs": {
 						"items": {
-							"$ref": "#/components/schemas/WithHref_Partial_Unbrand_XoAlarm___"
-						},
-						"type": "array"
-					},
-					{
-						"$ref": "#/components/schemas/NdjsonStream"
-					}
-				]
-			},
-			"Partial_Unbrand_XoVmSnapshot__": {
-				"properties": {
-					"$pool": {
-						"type": "string"
-					},
-					"$poolId": {
-						"type": "string",
-						"deprecated": true
-					},
-					"_xapiRef": {
-						"type": "string"
-					},
-					"uuid": {
-						"type": "string"
-					},
-					"$VBDs": {
-						"items": {
-							"type": "string"
-						},
-						"type": "array"
-					},
-					"$VGPUs": {
-						"items": {
-							"type": "string"
-						},
-						"type": "array"
-					},
-					"$container": {
-						"type": "string"
-					},
-					"CPUs": {
-						"properties": {
-							"number": {
-								"type": "number",
-								"format": "double"
-							},
-							"max": {
-								"type": "number",
-								"format": "double"
-							}
-						},
-						"required": [
-							"number",
-							"max"
-						],
-						"type": "object"
-					},
-					"PV_args": {
-						"type": "string"
-					},
-					"VGPUs": {
-						"items": {
-							"type": "string"
-						},
-						"type": "array"
-					},
-					"VIFs": {
-						"items": {
-							"type": "string"
-						},
-						"type": "array"
-					},
-					"VTPMs": {
-						"items": {
-							"type": "string"
+							"type": "string"
 						},
 						"type": "array"
 					},
@@ -4952,6 +4952,24 @@
 				],
 				"type": "object"
 			},
+			"UpdateUserRequestBody": {
+				"properties": {
+					"name": {
+						"type": "string"
+					},
+					"password": {
+						"type": "string"
+					},
+					"permission": {
+						"type": "string"
+					},
+					"preferences": {
+						"$ref": "#/components/schemas/Record_string.string_"
+					}
+				},
+				"type": "object",
+				"additionalProperties": false
+			},
 			"Record_string.STORAGE_OPERATIONS_": {
 				"properties": {},
 				"type": "object",
@@ -8624,6 +8642,15 @@
 				],
 				"type": "object"
 			},
+			"UpdateGroupRequestBody": {
+				"properties": {
+					"name": {
+						"type": "string"
+					}
+				},
+				"type": "object",
+				"additionalProperties": false
+			},
 			"Partial_Unbrand_XoBackupRepository__": {
 				"properties": {
 					"benchmarks": {
@@ -8834,7 +8861,6 @@
 									"VM",
 									"VM-snapshot",
 									"SR",
-									"VM-template",
 									"message",
 									"vgpu",
 									"gpuGroup",
@@ -8847,6 +8873,7 @@
 									"VDI-unmanaged",
 									"vgpuType",
 									"VM-controller",
+									"VM-template",
 									"SM",
 									"unknown"
 								]
@@ -8964,7 +8991,6 @@
 									"VM",
 									"VM-snapshot",
 									"SR",
-									"VM-template",
 									"message",
 									"vgpu",
 									"gpuGroup",
@@ -8977,6 +9003,7 @@
 									"VDI-unmanaged",
 									"vgpuType",
 									"VM-controller",
+									"VM-template",
 									"SM",
 									"unknown"
 								]
@@ -9017,7 +9044,7 @@
 	},
 	"info": {
 		"title": "@xen-orchestra/rest-api",
-		"version": "0.12.0",
+		"version": "0.13.1",
 		"description": "REST API to manage your XOA",
 		"license": {
 			"name": "AGPL-3.0-or-later"
@@ -11458,6 +11485,101 @@
 				}
 			}
 		},
+		"/vms/{id}/alarms": {
+			"get": {
+				"operationId": "GetVmAlarms",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoAlarm___"
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											{
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604b",
+												"time": 1747053794,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604b"
+											},
+											{
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604c",
+												"time": 1747053795,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604c"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"alarms",
+					"vms"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "f07ab729-c0e8-721c-45ec-f11276377030"
+					},
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "id,time"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "filter",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "time:>1747053793"
+					},
+					{
+						"in": "query",
+						"name": "limit",
+						"required": false,
+						"schema": {
+							"format": "double",
+							"type": "number"
+						},
+						"example": 42
+					}
+				]
+			}
+		},
 		"/vm-templates": {
 			"get": {
 				"operationId": "GetVmTemplates",
@@ -12093,35 +12215,29 @@
 				]
 			}
 		},
-		"/vm-controllers": {
+		"/vm-snapshots/{id}/alarms": {
 			"get": {
-				"operationId": "GetVmControllers",
+				"operationId": "GetVmSnapshotAlarms",
 				"responses": {
 					"200": {
 						"description": "Ok",
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoVmController___"
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoAlarm___"
 								},
 								"examples": {
 									"Example 1": {
-										"value": [
-											"/rest/v0/vm-controller/9b4775bd-9493-490a-9afa-f786a44caa4f",
-											"/rest/v0/vm-controller/e3fc847c-159a-48dc-bee4-cf2da216a795"
-										]
-									},
-									"Example 2": {
 										"value": [
 											{
-												"type": "VM-controller",
-												"uuid": "9b4775bd-9493-490a-9afa-f786a44caa4f",
-												"href": "/rest/v0/vm-controller/9b4775bd-9493-490a-9afa-f786a44caa4f"
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604b",
+												"time": 1747053794,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604b"
 											},
 											{
-												"type": "VM-controller",
-												"uuid": "e3fc847c-159a-48dc-bee4-cf2da216a795",
-												"href": "/rest/v0/vm-controller/e3fc847c-159a-48dc-bee4-cf2da216a795"
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604c",
+												"time": 1747053795,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604c"
 											}
 										]
 									}
@@ -12131,9 +12247,13 @@
 					},
 					"401": {
 						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
 					}
 				},
 				"tags": [
+					"alarms",
 					"vms"
 				],
 				"security": [
@@ -12142,6 +12262,15 @@
 					}
 				],
 				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "d68fca2c-41e6-be87-d790-105c1642a090"
+					},
 					{
 						"in": "query",
 						"name": "fields",
@@ -12149,7 +12278,7 @@
 						"schema": {
 							"type": "string"
 						},
-						"example": "type,uuid"
+						"example": "id,time"
 					},
 					{
 						"in": "query",
@@ -12166,7 +12295,7 @@
 						"schema": {
 							"type": "string"
 						},
-						"example": "power_state:Running"
+						"example": "time:>1747053793"
 					},
 					{
 						"in": "query",
@@ -12181,34 +12310,122 @@
 				]
 			}
 		},
-		"/vm-controllers/{id}": {
+		"/vm-controllers": {
 			"get": {
-				"operationId": "GetVmController",
+				"operationId": "GetVmControllers",
 				"responses": {
 					"200": {
 						"description": "Ok",
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "#/components/schemas/Unbrand_XoVmController_"
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoVmController___"
 								},
 								"examples": {
 									"Example 1": {
-										"value": {
-											"type": "VM-controller",
-											"addresses": {},
-											"affinityHost": "b61a5c92-700e-4966-a13b-00633f03eea8",
-											"auto_poweron": false,
-											"bios_strings": {},
-											"blockedOperations": {},
-											"boot": {},
-											"CPUs": {
-												"max": 8,
-												"number": 8
+										"value": [
+											"/rest/v0/vm-controller/9b4775bd-9493-490a-9afa-f786a44caa4f",
+											"/rest/v0/vm-controller/e3fc847c-159a-48dc-bee4-cf2da216a795"
+										]
+									},
+									"Example 2": {
+										"value": [
+											{
+												"type": "VM-controller",
+												"uuid": "9b4775bd-9493-490a-9afa-f786a44caa4f",
+												"href": "/rest/v0/vm-controller/9b4775bd-9493-490a-9afa-f786a44caa4f"
 											},
-											"current_operations": {},
-											"expNestedHvm": false,
-											"viridian": false,
+											{
+												"type": "VM-controller",
+												"uuid": "e3fc847c-159a-48dc-bee4-cf2da216a795",
+												"href": "/rest/v0/vm-controller/e3fc847c-159a-48dc-bee4-cf2da216a795"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					}
+				},
+				"tags": [
+					"vms"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "type,uuid"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "filter",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "power_state:Running"
+					},
+					{
+						"in": "query",
+						"name": "limit",
+						"required": false,
+						"schema": {
+							"format": "double",
+							"type": "number"
+						},
+						"example": 42
+					}
+				]
+			}
+		},
+		"/vm-controllers/{id}": {
+			"get": {
+				"operationId": "GetVmController",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Unbrand_XoVmController_"
+								},
+								"examples": {
+									"Example 1": {
+										"value": {
+											"type": "VM-controller",
+											"addresses": {},
+											"affinityHost": "b61a5c92-700e-4966-a13b-00633f03eea8",
+											"auto_poweron": false,
+											"bios_strings": {},
+											"blockedOperations": {},
+											"boot": {},
+											"CPUs": {
+												"max": 8,
+												"number": 8
+											},
+											"current_operations": {},
+											"expNestedHvm": false,
+											"viridian": false,
 											"high_availability": "",
 											"isFirmwareSupported": true,
 											"memory": {
@@ -12288,6 +12505,101 @@
 				]
 			}
 		},
+		"/vm-controllers/{id}/alarms": {
+			"get": {
+				"operationId": "GetVmControllerAlarms",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoAlarm___"
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											{
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604b",
+												"time": 1747053794,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604b"
+											},
+											{
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604c",
+												"time": 1747053795,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604c"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"alarms",
+					"vms"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "9b4775bd-9493-490a-9afa-f786a44caa4f"
+					},
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "id,time"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "filter",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "time:>1747053793"
+					},
+					{
+						"in": "query",
+						"name": "limit",
+						"required": false,
+						"schema": {
+							"format": "double",
+							"type": "number"
+						},
+						"example": 42
+					}
+				]
+			}
+		},
 		"/vifs": {
 			"get": {
 				"operationId": "GetVifs",
@@ -12443,6 +12755,101 @@
 				]
 			}
 		},
+		"/vifs/{id}/alarms": {
+			"get": {
+				"operationId": "GetVifAlarms",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoAlarm___"
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											{
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604b",
+												"time": 1747053794,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604b"
+											},
+											{
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604c",
+												"time": 1747053795,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604c"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"alarms",
+					"vifs"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "f028c5d4-578a-332c-394e-087aaca32dd3"
+					},
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "id,time"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "filter",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "time:>1747053793"
+					},
+					{
+						"in": "query",
+						"name": "limit",
+						"required": false,
+						"schema": {
+							"format": "double",
+							"type": "number"
+						},
+						"example": 42
+					}
+				]
+			}
+		},
 		"/vdis": {
 			"get": {
 				"operationId": "GetVdis",
@@ -13150,7 +13557,102 @@
 						"schema": {
 							"type": "string"
 						},
-						"example": "f07ab729-c0e8-721c-45ec-f11276377030"
+						"example": "f07ab729-c0e8-721c-45ec-f11276377030"
+					}
+				]
+			}
+		},
+		"/vbds/{id}/alarms": {
+			"get": {
+				"operationId": "GetVbdAlarms",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoAlarm___"
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											{
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604b",
+												"time": 1747053794,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604b"
+											},
+											{
+												"id": "7e87b95e-8ebb-31c5-30ad-ff2eb079604c",
+												"time": 1747053795,
+												"href": "/rest/v0/alarms/7e87b95e-8ebb-31c5-30ad-ff2eb079604c"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"alarms",
+					"vbds"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "f07ab729-c0e8-721c-45ec-f11276377030"
+					},
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "id,time"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "filter",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "time:>1747053793"
+					},
+					{
+						"in": "query",
+						"name": "limit",
+						"required": false,
+						"schema": {
+							"format": "double",
+							"type": "number"
+						},
+						"example": 42
 					}
 				]
 			}
@@ -13376,6 +13878,61 @@
 					}
 				]
 			},
+			"patch": {
+				"operationId": "UpdateUser",
+				"responses": {
+					"204": {
+						"description": "No content"
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"403": {
+						"description": "Forbidden"
+					},
+					"404": {
+						"description": "Resource not found"
+					},
+					"409": {
+						"description": "Resource already exists"
+					}
+				},
+				"tags": [
+					"users"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "722d17b9-699b-49d2-8193-be1ac573d3de"
+					}
+				],
+				"requestBody": {
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/UpdateUserRequestBody"
+							},
+							"example": {
+								"name": "updated user name",
+								"password": "newP4ssword",
+								"permission": "admin",
+								"preferences": {}
+							}
+						}
+					}
+				}
+			},
 			"delete": {
 				"operationId": "DeleteUser",
 				"responses": {
@@ -25292,6 +25849,75 @@
 						"example": 42
 					}
 				]
+			},
+			"post": {
+				"operationId": "CreateGroup",
+				"responses": {
+					"201": {
+						"description": "Resource created",
+						"content": {
+							"application/json": {
+								"schema": {
+									"properties": {
+										"id": {
+											"type": "string"
+										}
+									},
+									"required": [
+										"id"
+									],
+									"type": "object"
+								},
+								"examples": {
+									"Example 1": {
+										"value": {
+											"id": "67bfee1d-a021-4307-a53a-9fec2b2bd67d"
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"409": {
+						"description": "Resource already exists"
+					},
+					"422": {
+						"description": "Invalid parameters"
+					}
+				},
+				"tags": [
+					"groups"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [],
+				"requestBody": {
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"properties": {
+									"name": {
+										"type": "string"
+									}
+								},
+								"required": [
+									"name"
+								],
+								"type": "object"
+							},
+							"example": {
+								"name": "new group"
+							}
+						}
+					}
+				}
 			}
 		},
 		"/groups/{id}": {
@@ -25346,6 +25972,58 @@
 					}
 				]
 			},
+			"patch": {
+				"operationId": "UpdateGroup",
+				"responses": {
+					"204": {
+						"description": "No content"
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"403": {
+						"description": "Forbidden"
+					},
+					"404": {
+						"description": "Resource not found"
+					},
+					"409": {
+						"description": "Resource already exists"
+					}
+				},
+				"tags": [
+					"groups"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "c98395a7-26d8-4e09-b055-d5f0f4a98312"
+					}
+				],
+				"requestBody": {
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"$ref": "#/components/schemas/UpdateGroupRequestBody"
+							},
+							"example": {
+								"name": "new group name"
+							}
+						}
+					}
+				}
+			},
 			"delete": {
 				"operationId": "DeleteGroup",
 				"responses": {
@@ -25380,6 +26058,98 @@
 				]
 			}
 		},
+		"/groups/{id}/users/{userId}": {
+			"delete": {
+				"operationId": "RemoveUserFromGroup",
+				"responses": {
+					"204": {
+						"description": "No content"
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"403": {
+						"description": "Forbidden"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"groups"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "c98395a7-26d8-4e09-b055-d5f0f4a98312"
+					},
+					{
+						"in": "path",
+						"name": "userId",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "722d17b9-699b-49d2-8193-be1ac573d3de"
+					}
+				]
+			},
+			"put": {
+				"operationId": "AddUserToGroup",
+				"responses": {
+					"204": {
+						"description": "No content"
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"403": {
+						"description": "Forbidden"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"groups"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "6c81b5e1-afc1-43ea-8f8d-939ceb5f3f90"
+					},
+					{
+						"in": "path",
+						"name": "userId",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "722d17b9-699b-49d2-8193-be1ac573d3de"
+					}
+				]
+			}
+		},
 		"/backup-repositories": {
 			"get": {
 				"operationId": "GetRepositories",