@xen-orchestra/rest-api 0.14.0 → 0.15.0

package/open-api/spec/swagger.json

@@ -5184,6 +5184,379 @@
 				"type": "object",
 				"additionalProperties": false
 			},
+			"Record_string.unknown_": {
+				"properties": {},
+				"type": "object",
+				"description": "Construct a type with a set of properties K of type T"
+			},
+			"Branded_task_": {
+				"allOf": [
+					{
+						"type": "string"
+					},
+					{
+						"properties": {
+							"undefined": {
+								"type": "string",
+								"enum": [
+									"task"
+								],
+								"nullable": false
+							}
+						},
+						"required": [
+							null
+						],
+						"type": "object"
+					}
+				]
+			},
+			"XoTask": {
+				"properties": {
+					"warning": {
+						"items": {
+							"properties": {
+								"message": {
+									"type": "string"
+								},
+								"data": {}
+							},
+							"required": [
+								"message",
+								"data"
+							],
+							"type": "object"
+						},
+						"type": "array"
+					},
+					"updatedAt": {
+						"type": "number",
+						"format": "double"
+					},
+					"tasks": {
+						"items": {
+							"$ref": "#/components/schemas/XoTask"
+						},
+						"type": "array"
+					},
+					"status": {
+						"type": "string",
+						"enum": [
+							"failure",
+							"interrupted",
+							"pending",
+							"success"
+						]
+					},
+					"start": {
+						"type": "number",
+						"format": "double"
+					},
+					"result": {
+						"$ref": "#/components/schemas/Record_string.unknown_"
+					},
+					"properties": {
+						"properties": {
+							"userId": {
+								"type": "string"
+							},
+							"type": {
+								"type": "string"
+							},
+							"params": {
+								"$ref": "#/components/schemas/Record_string.unknown_"
+							},
+							"objectId": {
+								"type": "string"
+							},
+							"name": {
+								"type": "string"
+							},
+							"method": {
+								"type": "string"
+							}
+						},
+						"additionalProperties": {},
+						"type": "object"
+					},
+					"infos": {
+						"items": {
+							"properties": {
+								"message": {
+									"type": "string"
+								},
+								"data": {}
+							},
+							"required": [
+								"message",
+								"data"
+							],
+							"type": "object"
+						},
+						"type": "array"
+					},
+					"id": {
+						"$ref": "#/components/schemas/Branded_task_"
+					},
+					"end": {
+						"type": "number",
+						"format": "double"
+					},
+					"abortionRequestedAt": {
+						"type": "number",
+						"format": "double"
+					}
+				},
+				"required": [
+					"status",
+					"start",
+					"result",
+					"properties",
+					"id"
+				],
+				"type": "object"
+			},
+			"Partial_Unbrand_XoTask__": {
+				"properties": {
+					"abortionRequestedAt": {
+						"type": "number",
+						"format": "double"
+					},
+					"end": {
+						"type": "number",
+						"format": "double"
+					},
+					"id": {
+						"type": "string"
+					},
+					"infos": {
+						"items": {
+							"properties": {
+								"message": {
+									"type": "string"
+								},
+								"data": {}
+							},
+							"required": [
+								"message",
+								"data"
+							],
+							"type": "object"
+						},
+						"type": "array"
+					},
+					"properties": {
+						"properties": {
+							"userId": {
+								"type": "string"
+							},
+							"type": {
+								"type": "string"
+							},
+							"params": {
+								"$ref": "#/components/schemas/Record_string.unknown_"
+							},
+							"objectId": {
+								"type": "string"
+							},
+							"name": {
+								"type": "string"
+							},
+							"method": {
+								"type": "string"
+							}
+						},
+						"additionalProperties": {},
+						"type": "object"
+					},
+					"result": {
+						"$ref": "#/components/schemas/Record_string.unknown_"
+					},
+					"start": {
+						"type": "number",
+						"format": "double"
+					},
+					"status": {
+						"type": "string",
+						"enum": [
+							"failure",
+							"interrupted",
+							"pending",
+							"success"
+						]
+					},
+					"tasks": {
+						"items": {
+							"$ref": "#/components/schemas/XoTask"
+						},
+						"type": "array"
+					},
+					"updatedAt": {
+						"type": "number",
+						"format": "double"
+					},
+					"warning": {
+						"items": {
+							"properties": {
+								"message": {
+									"type": "string"
+								},
+								"data": {}
+							},
+							"required": [
+								"message",
+								"data"
+							],
+							"type": "object"
+						},
+						"type": "array"
+					}
+				},
+				"type": "object",
+				"description": "Make all properties in T optional"
+			},
+			"WithHref_Partial_Unbrand_XoTask___": {
+				"allOf": [
+					{
+						"$ref": "#/components/schemas/Partial_Unbrand_XoTask__"
+					},
+					{
+						"properties": {
+							"href": {
+								"type": "string"
+							}
+						},
+						"required": [
+							"href"
+						],
+						"type": "object"
+					}
+				]
+			},
+			"SendObjects_Partial_Unbrand_XoTask___": {
+				"anyOf": [
+					{
+						"items": {
+							"type": "string"
+						},
+						"type": "array"
+					},
+					{
+						"items": {
+							"$ref": "#/components/schemas/WithHref_Partial_Unbrand_XoTask___"
+						},
+						"type": "array"
+					},
+					{
+						"$ref": "#/components/schemas/NdjsonStream"
+					}
+				]
+			},
+			"Unbrand_XoTask_": {
+				"properties": {
+					"abortionRequestedAt": {
+						"type": "number",
+						"format": "double"
+					},
+					"end": {
+						"type": "number",
+						"format": "double"
+					},
+					"id": {
+						"type": "string"
+					},
+					"infos": {
+						"items": {
+							"properties": {
+								"message": {
+									"type": "string"
+								},
+								"data": {}
+							},
+							"required": [
+								"message",
+								"data"
+							],
+							"type": "object"
+						},
+						"type": "array"
+					},
+					"properties": {
+						"properties": {
+							"userId": {
+								"type": "string"
+							},
+							"type": {
+								"type": "string"
+							},
+							"params": {
+								"$ref": "#/components/schemas/Record_string.unknown_"
+							},
+							"objectId": {
+								"type": "string"
+							},
+							"name": {
+								"type": "string"
+							},
+							"method": {
+								"type": "string"
+							}
+						},
+						"additionalProperties": {},
+						"type": "object"
+					},
+					"result": {
+						"$ref": "#/components/schemas/Record_string.unknown_"
+					},
+					"start": {
+						"type": "number",
+						"format": "double"
+					},
+					"status": {
+						"type": "string",
+						"enum": [
+							"failure",
+							"interrupted",
+							"pending",
+							"success"
+						]
+					},
+					"tasks": {
+						"items": {
+							"$ref": "#/components/schemas/XoTask"
+						},
+						"type": "array"
+					},
+					"updatedAt": {
+						"type": "number",
+						"format": "double"
+					},
+					"warning": {
+						"items": {
+							"properties": {
+								"message": {
+									"type": "string"
+								},
+								"data": {}
+							},
+							"required": [
+								"message",
+								"data"
+							],
+							"type": "object"
+						},
+						"type": "array"
+					}
+				},
+				"required": [
+					"id",
+					"properties",
+					"result",
+					"start",
+					"status"
+				],
+				"type": "object"
+			},
 			"Record_string.STORAGE_OPERATIONS_": {
 				"properties": {},
 				"type": "object",
@@ -5624,11 +5997,6 @@
 				],
 				"type": "object"
 			},
-			"Record_string.unknown_": {
-				"properties": {},
-				"type": "object",
-				"description": "Construct a type with a set of properties K of type T"
-			},
 			"Partial_Unbrand_XoServer__": {
 				"properties": {
 					"allowUnauthorized": {
@@ -6840,17 +7208,20 @@
 									{
 										"properties": {
 											"missingPatches": {
-												"items": {
-													"anyOf": [
-														{
+												"anyOf": [
+													{
+														"items": {
 															"$ref": "#/components/schemas/XcpPatches"
 														},
-														{
+														"type": "array"
+													},
+													{
+														"items": {
 															"$ref": "#/components/schemas/XsPatches"
-														}
-													]
-												},
-												"type": "array"
+														},
+														"type": "array"
+													}
+												]
 											},
 											"hasAuthorization": {
 												"type": "boolean",
@@ -9258,7 +9629,7 @@
 	},
 	"info": {
 		"title": "@xen-orchestra/rest-api",
-		"version": "0.14.0",
+		"version": "0.15.0",
 		"description": "REST API to manage your XOA",
 		"license": {
 			"name": "AGPL-3.0-or-later"
@@ -14420,33 +14791,300 @@
 							}
 						}
 					}
-				}
+				}
+			}
+		},
+		"/users/{id}": {
+			"get": {
+				"operationId": "GetUser",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Unbrand_XoUser_"
+								},
+								"examples": {
+									"Example 1": {
+										"value": {
+											"email": "admin@admin.net",
+											"permission": "admin",
+											"pw_hash": "***obfuscated***",
+											"groups": [
+												"7d98fee4-3357-41a7-ac3f-9124212badb7",
+												"7981ba62-c395-4546-bfa4-d1261653a77f"
+											],
+											"name": "admin@admin.net",
+											"preferences": {},
+											"id": "722d17b9-699b-49d2-8193-be1ac573d3de"
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"users"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "722d17b9-699b-49d2-8193-be1ac573d3de"
+					}
+				]
+			},
+			"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": {
+					"204": {
+						"description": "No content"
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"users"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "722d17b9-699b-49d2-8193-be1ac573d3de"
+					}
+				]
+			}
+		},
+		"/tasks": {
+			"get": {
+				"operationId": "GetTasks",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/SendObjects_Partial_Unbrand_XoTask___"
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											"/rest/v0/tasks/0mdd1basu",
+											"/rest/v0/tasks/0mdd1t24g"
+										]
+									},
+									"Example 2": {
+										"value": [
+											{
+												"status": "failure",
+												"id": "0mdd1basu",
+												"properties": {
+													"method": "xoa.licenses.getSelf",
+													"params": {},
+													"name": "API call: xoa.licenses.getSelf",
+													"userId": "e531b8c9-3876-4ed9-8fd2-0476d5f825c9",
+													"type": "api.call"
+												},
+												"href": "/rest/v0/tasks/0mdd1basu"
+											},
+											{
+												"status": "failure",
+												"id": "0mdd1t24g",
+												"properties": {
+													"method": "xoa.licenses.getSelf",
+													"params": {},
+													"name": "API call: xoa.licenses.getSelf",
+													"userId": "e531b8c9-3876-4ed9-8fd2-0476d5f825c9",
+													"type": "api.call"
+												},
+												"href": "/rest/v0/tasks/0mdd1t24g"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"400": {
+						"description": "Bad request"
+					},
+					"401": {
+						"description": "Authentication required"
+					}
+				},
+				"description": "\nIf watch is true, ndjson must also be true",
+				"tags": [
+					"tasks"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "status,id,properties"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "watch",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "filter",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "status:failure"
+					},
+					{
+						"in": "query",
+						"name": "limit",
+						"required": false,
+						"schema": {
+							"format": "double",
+							"type": "number"
+						},
+						"example": 42
+					}
+				]
 			}
 		},
-		"/users/{id}": {
+		"/tasks/{id}": {
 			"get": {
-				"operationId": "GetUser",
+				"operationId": "GetTask",
 				"responses": {
 					"200": {
 						"description": "Ok",
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "#/components/schemas/Unbrand_XoUser_"
+									"$ref": "#/components/schemas/Unbrand_XoTask_"
 								},
 								"examples": {
 									"Example 1": {
 										"value": {
-											"email": "admin@admin.net",
-											"permission": "admin",
-											"pw_hash": "***obfuscated***",
-											"groups": [
-												"7d98fee4-3357-41a7-ac3f-9124212badb7",
-												"7981ba62-c395-4546-bfa4-d1261653a77f"
-											],
-											"name": "admin@admin.net",
-											"preferences": {},
-											"id": "722d17b9-699b-49d2-8193-be1ac573d3de"
+											"id": "0mdd1basu",
+											"properties": {
+												"method": "xoa.licenses.getSelf",
+												"params": {},
+												"name": "API call: xoa.licenses.getSelf",
+												"userId": "e531b8c9-3876-4ed9-8fd2-0476d5f825c9",
+												"type": "api.call"
+											},
+											"start": 1753098047598,
+											"status": "failure",
+											"updatedAt": 1753098047696,
+											"end": 1753098047600,
+											"result": {
+												"message": "invalid status closed, expected open",
+												"name": "ConnectionError",
+												"stack": "ConnectionError: invalid status closed, expected open\n    at JsonRpcWebSocketClient._assertStatus (/home/debian/xoa/node_modules/jsonrpc-websocket-client/src/websocket-client.js:141:13)\n    at JsonRpcWebSocketClient.send (/home/debian/xoa/node_modules/jsonrpc-websocket-client/src/websocket-client.js:128:10)\n    at Peer.<anonymous> (/home/debian/xoa/node_modules/jsonrpc-websocket-client/src/index.js:47:12)\n    at Peer.emit (node:events:518:28)\n    at Peer.emit (/home/debian/xen-orchestra/@xen-orchestra/log/configure.js:52:17)\n    at Peer.push (/home/debian/xoa/node_modules/json-rpc-peer/src/index.js:196:52)\n    at /home/debian/xoa/node_modules/json-rpc-peer/src/index.js:142:12\n    at Promise._execute (/home/debian/xen-orchestra/node_modules/bluebird/js/release/debuggability.js:384:9)\n    at Promise._resolveFromExecutor (/home/debian/xen-orchestra/node_modules/bluebird/js/release/promise.js:518:18)\n    at new Promise (/home/debian/xen-orchestra/node_modules/bluebird/js/release/promise.js:103:10)\n    at Peer.request (/home/debian/xoa/node_modules/json-rpc-peer/src/index.js:139:12)\n    at JsonRpcWebSocketClient.call (/home/debian/xoa/node_modules/jsonrpc-websocket-client/src/index.js:63:23)\n    at Xoa.apply [as _getSelfLicenses] (/home/debian/xoa/packages/xo-server-xoa/src/index.js:929:26)\n    at Xo.call (file:///home/debian/xen-orchestra/packages/xo-server/src/xo-mixins/api.mjs:269:25)\n    at file:///home/debian/xen-orchestra/packages/xo-server/src/xo-mixins/api.mjs:421:33\n    at AsyncLocalStorage.run (node:internal/async_local_storage/async_hooks:91:14)\n    at Task.runInside (/home/debian/xen-orchestra/@vates/task/index.js:175:41)\n    at Task.run (/home/debian/xen-orchestra/@vates/task/index.js:159:31)\n    at run (file:///home/debian/xen-orchestra/packages/xo-server/src/xo-mixins/api.mjs:421:16)\n    at Api.#callApiMethod (file:///home/debian/xen-orchestra/packages/xo-server/src/xo-mixins/api.mjs:469:24)"
+											}
 										}
 									}
 								}
@@ -14461,7 +15099,7 @@
 					}
 				},
 				"tags": [
-					"users"
+					"tasks"
 				],
 				"security": [
 					{
@@ -14476,96 +15114,16 @@
 						"schema": {
 							"type": "string"
 						},
-						"example": "722d17b9-699b-49d2-8193-be1ac573d3de"
-					}
-				]
-			},
-			"patch": {
-				"operationId": "UpdateUser",
-				"responses": {
-					"204": {
-						"description": "No content"
-					},
-					"401": {
-						"description": "Authentication required"
-					},
-					"403": {
-						"description": "Forbidden"
-					},
-					"404": {
-						"description": "Resource not found"
+						"example": "0mdd1basu"
 					},
-					"409": {
-						"description": "Resource already exists"
-					}
-				},
-				"tags": [
-					"users"
-				],
-				"security": [
-					{
-						"*": []
-					}
-				],
-				"parameters": [
 					{
-						"in": "path",
-						"name": "id",
-						"required": true,
+						"in": "query",
+						"name": "wait",
+						"required": false,
 						"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": {}
-							}
+							"type": "boolean"
 						}
 					}
-				}
-			},
-			"delete": {
-				"operationId": "DeleteUser",
-				"responses": {
-					"204": {
-						"description": "No content"
-					},
-					"401": {
-						"description": "Authentication required"
-					},
-					"404": {
-						"description": "Resource not found"
-					}
-				},
-				"tags": [
-					"users"
-				],
-				"security": [
-					{
-						"*": []
-					}
-				],
-				"parameters": [
-					{
-						"in": "path",
-						"name": "id",
-						"required": true,
-						"schema": {
-							"type": "string"
-						},
-						"example": "722d17b9-699b-49d2-8193-be1ac573d3de"
-					}
 				]
 			}
 		},
@@ -18598,6 +19156,98 @@
 				]
 			}
 		},
+		"/pools/{id}/missing_patches": {
+			"get": {
+				"operationId": "GetPoolMissingPatches",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"anyOf": [
+										{
+											"items": {
+												"$ref": "#/components/schemas/XcpPatches"
+											},
+											"type": "array"
+										},
+										{
+											"items": {
+												"$ref": "#/components/schemas/XsPatches"
+											},
+											"type": "array"
+										}
+									]
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											{
+												"url": "http://www.samba.org/",
+												"version": "4.10.16",
+												"name": "libsmbclient",
+												"license": "GPLv3+ and LGPLv3+",
+												"changelog": {
+													"date": 1690286400,
+													"description": "- resolves: #2222250 - Fix netlogon capabilities level 2",
+													"author": "Andreas Schneider <asn@redhat.com> - 4.10.16-25"
+												},
+												"release": "25.el7_9",
+												"size": 149400,
+												"description": "The SMB client library"
+											},
+											{
+												"url": "http://www.openssh.com/portable.html",
+												"version": "7.4p1",
+												"name": "openssh",
+												"license": "BSD",
+												"changelog": {
+													"date": 1742212800,
+													"description": "- Fix CVE-2025-26465 - Fix cases where error codes were not correctly set",
+													"author": "Lucas Ravagnier <lucas.ravagnier@vates.tech> - 7.4p1-23.3.2 + 0.10.3-2.23.3.2"
+												},
+												"release": "23.3.2.xcpng8.2",
+												"size": 429044,
+												"description": "An open source implementation of SSH protocol versions 1 and 2"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"403": {
+						"description": "Feature unauthorized"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"pools"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "355ee47d-ff4c-4924-3db2-fd86ae629676"
+					}
+				]
+			}
+		},
 		"/pifs": {
 			"get": {
 				"operationId": "GetPifs",
@@ -26419,6 +27069,99 @@
 				]
 			}
 		},
+		"/hosts/{id}/missing_patches": {
+			"get": {
+				"operationId": "GetMissingPatches",
+				"responses": {
+					"200": {
+						"description": "Ok",
+						"content": {
+							"application/json": {
+								"schema": {
+									"anyOf": [
+										{
+											"items": {
+												"$ref": "#/components/schemas/XcpPatches"
+											},
+											"type": "array"
+										},
+										{
+											"items": {
+												"$ref": "#/components/schemas/XsPatches"
+											},
+											"type": "array"
+										}
+									]
+								},
+								"examples": {
+									"Example 1": {
+										"value": [
+											{
+												"url": "http://www.samba.org/",
+												"version": "4.10.16",
+												"name": "libsmbclient",
+												"license": "GPLv3+ and LGPLv3+",
+												"changelog": {
+													"date": 1690286400,
+													"description": "- resolves: #2222250 - Fix netlogon capabilities level 2",
+													"author": "Andreas Schneider <asn@redhat.com> - 4.10.16-25"
+												},
+												"release": "25.el7_9",
+												"size": 149400,
+												"description": "The SMB client library"
+											},
+											{
+												"url": "http://www.openssh.com/portable.html",
+												"version": "7.4p1",
+												"name": "openssh",
+												"license": "BSD",
+												"changelog": {
+													"date": 1742212800,
+													"description": "- Fix CVE-2025-26465 - Fix cases where error codes were not correctly set",
+													"author": "Lucas Ravagnier <lucas.ravagnier@vates.tech> - 7.4p1-23.3.2 + 0.10.3-2.23.3.2"
+												},
+												"release": "23.3.2.xcpng8.2",
+												"size": 429044,
+												"description": "An open source implementation of SSH protocol versions 1 and 2"
+											}
+										]
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"403": {
+						"description": "Feature unauthorized"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"description": "Host must be running",
+				"tags": [
+					"hosts"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "b61a5c92-700e-4966-a13b-00633f03eea8"
+					}
+				]
+			}
+		},
 		"/groups": {
 			"get": {
 				"operationId": "GetGroups",
@@ -27210,6 +27953,20 @@
 					}
 				}
 			}
+		},
+		"/docs/swagger.json": {
+			"get": {
+				"operationId": "swaggerSpec",
+				"description": "Returns the swagger json ready to use for REST API clients",
+				"responses": {
+					"200": {
+						"description": "Ok"
+					}
+				},
+				"tags": [
+					"docs"
+				]
+			}
 		}
 	}
 }