@xen-orchestra/rest-api 0.28.2 → 0.29.0

package/open-api/spec/swagger.json

@@ -931,7 +931,8 @@
 					},
 					"videoram": {
 						"type": "number",
-						"format": "double"
+						"format": "double",
+						"description": "Value in MiB.\nSee: https://wiki.xenproject.org/wiki/XCP_PV_templates_start"
 					},
 					"viridian": {
 						"type": "boolean"
@@ -1060,6 +1061,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -1341,7 +1345,8 @@
 					},
 					"videoram": {
 						"type": "number",
-						"format": "double"
+						"format": "double",
+						"description": "Value in MiB.\nSee: https://wiki.xenproject.org/wiki/XCP_PV_templates_start"
 					},
 					"viridian": {
 						"type": "boolean"
@@ -1816,6 +1821,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -1914,6 +1922,10 @@
 					"id": {
 						"type": "string"
 					},
+					"chainPhysicalUsage": {
+						"type": "number",
+						"format": "double"
+					},
 					"type": {
 						"type": "string",
 						"enum": [
@@ -1958,6 +1970,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -2211,6 +2226,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -2289,6 +2307,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -2656,6 +2677,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -3187,7 +3211,8 @@
 					},
 					"videoram": {
 						"type": "number",
-						"format": "double"
+						"format": "double",
+						"description": "Value in MiB.\nSee: https://wiki.xenproject.org/wiki/XCP_PV_templates_start"
 					},
 					"viridian": {
 						"type": "boolean"
@@ -3335,6 +3360,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -3616,7 +3644,8 @@
 					},
 					"videoram": {
 						"type": "number",
-						"format": "double"
+						"format": "double",
+						"description": "Value in MiB.\nSee: https://wiki.xenproject.org/wiki/XCP_PV_templates_start"
 					},
 					"viridian": {
 						"type": "boolean"
@@ -4051,7 +4080,8 @@
 					},
 					"videoram": {
 						"type": "number",
-						"format": "double"
+						"format": "double",
+						"description": "Value in MiB.\nSee: https://wiki.xenproject.org/wiki/XCP_PV_templates_start"
 					},
 					"viridian": {
 						"type": "boolean"
@@ -4154,6 +4184,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -4435,7 +4468,8 @@
 					},
 					"videoram": {
 						"type": "number",
-						"format": "double"
+						"format": "double",
+						"description": "Value in MiB.\nSee: https://wiki.xenproject.org/wiki/XCP_PV_templates_start"
 					},
 					"viridian": {
 						"type": "boolean"
@@ -4672,6 +4706,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -4953,7 +4990,8 @@
 					},
 					"videoram": {
 						"type": "number",
-						"format": "double"
+						"format": "double",
+						"description": "Value in MiB.\nSee: https://wiki.xenproject.org/wiki/XCP_PV_templates_start"
 					},
 					"viridian": {
 						"type": "boolean"
@@ -5046,6 +5084,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -5327,7 +5368,8 @@
 					},
 					"videoram": {
 						"type": "number",
-						"format": "double"
+						"format": "double",
+						"description": "Value in MiB.\nSee: https://wiki.xenproject.org/wiki/XCP_PV_templates_start"
 					},
 					"viridian": {
 						"type": "boolean"
@@ -5543,6 +5585,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -5797,6 +5842,10 @@
 					"id": {
 						"type": "string"
 					},
+					"chainPhysicalUsage": {
+						"type": "number",
+						"format": "double"
+					},
 					"type": {
 						"type": "string",
 						"enum": [
@@ -5823,11 +5872,12 @@
 					"tags",
 					"usage",
 					"id",
+					"chainPhysicalUsage",
 					"type"
 				],
 				"type": "object"
 			},
-			"Pick_CreateVdiParams_91_0_93_.Exclude_keyofCreateVdiParams_91_0_93_.SR__": {
+			"Pick_CreateVdiParams_91_0_93_.Exclude_keyofCreateVdiParams_91_0_93_.SR-or-other_config__": {
 				"properties": {
 					"name_description": {
 						"type": "string"
@@ -5844,9 +5894,6 @@
 					"type": {
 						"$ref": "#/components/schemas/VDI_TYPE"
 					},
-					"other_config": {
-						"$ref": "#/components/schemas/Record_string.string_"
-					},
 					"read_only": {
 						"type": "boolean"
 					},
@@ -5867,22 +5914,30 @@
 				"type": "object",
 				"description": "From T, pick a set of properties whose keys are in the union K"
 			},
-			"Omit_CreateVdiParams_91_0_93_.SR_": {
-				"$ref": "#/components/schemas/Pick_CreateVdiParams_91_0_93_.Exclude_keyofCreateVdiParams_91_0_93_.SR__",
+			"Omit_CreateVdiParams_91_0_93_.SR-or-other_config_": {
+				"$ref": "#/components/schemas/Pick_CreateVdiParams_91_0_93_.Exclude_keyofCreateVdiParams_91_0_93_.SR-or-other_config__",
 				"description": "Construct a type with the properties of T except for those in type K."
 			},
 			"CreateVdiBody": {
 				"allOf": [
 					{
-						"$ref": "#/components/schemas/Omit_CreateVdiParams_91_0_93_.SR_"
+						"$ref": "#/components/schemas/Omit_CreateVdiParams_91_0_93_.SR-or-other_config_"
 					},
 					{
 						"properties": {
+							"other_config": {
+								"properties": {},
+								"additionalProperties": {
+									"type": "string"
+								},
+								"type": "object"
+							},
 							"srId": {
 								"type": "string"
 							}
 						},
 						"required": [
+							"other_config",
 							"srId"
 						],
 						"type": "object"
@@ -6174,6 +6229,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -6312,6 +6370,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -6430,6 +6491,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -6772,6 +6836,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -6995,6 +7062,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -7163,6 +7233,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -7317,6 +7390,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -7415,6 +7491,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -7512,6 +7591,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -7741,6 +7823,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -9031,6 +9116,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -9295,6 +9383,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -9462,6 +9553,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -9687,6 +9781,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -9956,6 +10053,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -10130,6 +10230,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -10591,6 +10694,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -11105,6 +11211,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -11258,6 +11367,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -11567,6 +11679,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -11827,6 +11942,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -11910,6 +12028,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -12048,6 +12169,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -12292,6 +12416,9 @@
 					},
 					{
 						"$ref": "#/components/schemas/NdjsonStream"
+					},
+					{
+						"type": "string"
 					}
 				]
 			},
@@ -12418,7 +12545,7 @@
 	},
 	"info": {
 		"title": "@xen-orchestra/rest-api",
-		"version": "0.28.2",
+		"version": "0.29.0",
 		"description": "REST API to manage your XOA",
 		"license": {
 			"name": "AGPL-3.0-or-later"
@@ -12669,6 +12796,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -15227,6 +15362,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -15327,6 +15470,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -15435,6 +15586,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -15543,6 +15702,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -15661,6 +15828,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -16103,6 +16278,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -16446,6 +16629,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -16546,6 +16737,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -16654,6 +16853,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -16772,6 +16979,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -16957,6 +17172,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -17400,6 +17623,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -17500,6 +17731,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -17608,6 +17847,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -17726,6 +17973,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -17909,6 +18164,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -18117,6 +18380,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -18217,6 +18488,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -18325,6 +18604,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -18443,6 +18730,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -18628,6 +18923,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -18901,6 +19204,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -19009,6 +19320,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -19127,6 +19446,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -19149,6 +19476,140 @@
 				]
 			}
 		},
+		"/vifs/{id}/actions/connect": {
+			"post": {
+				"operationId": "ConnectVif",
+				"responses": {
+					"202": {
+						"description": "Action executed asynchronously",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/CreateActionReturnType_void_"
+								},
+								"examples": {
+									"Example 1": {
+										"value": {
+											"taskId": "0m7kl0j9l"
+										}
+									}
+								}
+							}
+						}
+					},
+					"204": {
+						"description": "No content"
+					},
+					"400": {
+						"description": "Bad request"
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					},
+					"500": {
+						"description": "Internal server error, XenServer/XCP-ng error"
+					}
+				},
+				"description": "Hotplug the VIF, dynamically attaching it to the running VM\nRequires PV drivers to be installed on the VM",
+				"tags": [
+					"vifs"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "f07ab729-c0e8-721c-45ec-f11276377030"
+					},
+					{
+						"in": "query",
+						"name": "sync",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					}
+				]
+			}
+		},
+		"/vifs/{id}/actions/disconnect": {
+			"post": {
+				"operationId": "DisconnectVif",
+				"responses": {
+					"202": {
+						"description": "Action executed asynchronously",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/CreateActionReturnType_void_"
+								},
+								"examples": {
+									"Example 1": {
+										"value": {
+											"taskId": "0m7kl0j9l"
+										}
+									}
+								}
+							}
+						}
+					},
+					"204": {
+						"description": "No content"
+					},
+					"400": {
+						"description": "Bad request"
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"404": {
+						"description": "Resource not found"
+					},
+					"500": {
+						"description": "Internal server error, XenServer/XCP-ng error"
+					}
+				},
+				"description": "Hot-unplug the VIF, dynamically detaching it from the running VM\nRequires PV drivers to be installed on the VM",
+				"tags": [
+					"vifs"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "f07ab729-c0e8-721c-45ec-f11276377030"
+					},
+					{
+						"in": "query",
+						"name": "sync",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					}
+				]
+			}
+		},
 		"/vdis": {
 			"get": {
 				"operationId": "GetVdis",
@@ -19269,6 +19730,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -19542,6 +20011,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -19650,6 +20127,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -19768,6 +20253,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -20045,6 +20538,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -20313,6 +20814,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -20421,6 +20930,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -20539,6 +21056,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -20811,6 +21336,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -21011,6 +21544,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -21119,6 +21660,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -21237,6 +21786,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -21463,6 +22020,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -21807,6 +22372,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -22101,14 +22674,238 @@
 					},
 					"401": {
 						"description": "Authentication required"
-					},
-					"404": {
-						"description": "Resource not found"
+					},
+					"404": {
+						"description": "Resource not found"
+					}
+				},
+				"tags": [
+					"tasks",
+					"users"
+				],
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [
+					{
+						"in": "path",
+						"name": "id",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"example": "722d17b9-699b-49d2-8193-be1ac573d3de"
+					},
+					{
+						"in": "query",
+						"name": "fields",
+						"required": false,
+						"schema": {
+							"type": "string"
+						},
+						"example": "id,status,properties"
+					},
+					{
+						"in": "query",
+						"name": "ndjson",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"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/authentication_tokens": {
+			"post": {
+				"operationId": "PostDeprecatedAuthenticationTokens",
+				"responses": {
+					"201": {
+						"description": "Resource created",
+						"content": {
+							"application/json": {
+								"schema": {
+									"properties": {
+										"token": {
+											"$ref": "#/components/schemas/Unbrand_XoAuthenticationToken_"
+										}
+									},
+									"required": [
+										"token"
+									],
+									"type": "object"
+								},
+								"examples": {
+									"Example 1": {
+										"value": {
+											"token": {
+												"client": {
+													"id": "my-fav-client"
+												},
+												"created_at": 1760346600297,
+												"description": "token for CLI usage",
+												"id": "fhIUz8AtMLndzMd3ksfoTpHb0tWyKHmT6-M3o_hUbRg",
+												"user_id": "722d17b9-699b-49d2-8193-be1ac573d3de",
+												"expiration": 1760350200297
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"400": {
+						"description": "Bad request"
+					},
+					"401": {
+						"description": "Authentication required"
+					},
+					"500": {
+						"description": "Internal server error, XenServer/XCP-ng error"
+					}
+				},
+				"tags": [
+					"users"
+				],
+				"deprecated": true,
+				"security": [
+					{
+						"*": []
+					}
+				],
+				"parameters": [],
+				"requestBody": {
+					"required": true,
+					"content": {
+						"application/json": {
+							"schema": {
+								"properties": {
+									"expiresIn": {
+										"anyOf": [
+											{
+												"type": "string"
+											},
+											{
+												"type": "number",
+												"format": "double"
+											}
+										]
+									},
+									"description": {
+										"type": "string"
+									},
+									"client": {
+										"properties": {
+											"id": {
+												"type": "string"
+											}
+										},
+										"type": "object"
+									}
+								},
+								"type": "object"
+							},
+							"example": {
+								"client": {
+									"id": "my-fav-client"
+								},
+								"description": "token for CLI usage",
+								"expiresIn": "1 hour"
+							}
+						}
+					}
+				}
+			}
+		},
+		"/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",
-					"users"
+					"tasks"
 				],
 				"security": [
 					{
@@ -22116,15 +22913,6 @@
 					}
 				],
 				"parameters": [
-					{
-						"in": "path",
-						"name": "id",
-						"required": true,
-						"schema": {
-							"type": "string"
-						},
-						"example": "722d17b9-699b-49d2-8193-be1ac573d3de"
-					},
 					{
 						"in": "query",
 						"name": "fields",
@@ -22132,7 +22920,7 @@
 						"schema": {
 							"type": "string"
 						},
-						"example": "id,status,properties"
+						"example": "status,id,properties"
 					},
 					{
 						"in": "query",
@@ -22144,206 +22932,7 @@
 					},
 					{
 						"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/authentication_tokens": {
-			"post": {
-				"operationId": "PostDeprecatedAuthenticationTokens",
-				"responses": {
-					"201": {
-						"description": "Resource created",
-						"content": {
-							"application/json": {
-								"schema": {
-									"properties": {
-										"token": {
-											"$ref": "#/components/schemas/Unbrand_XoAuthenticationToken_"
-										}
-									},
-									"required": [
-										"token"
-									],
-									"type": "object"
-								},
-								"examples": {
-									"Example 1": {
-										"value": {
-											"token": {
-												"client": {
-													"id": "my-fav-client"
-												},
-												"created_at": 1760346600297,
-												"description": "token for CLI usage",
-												"id": "fhIUz8AtMLndzMd3ksfoTpHb0tWyKHmT6-M3o_hUbRg",
-												"user_id": "722d17b9-699b-49d2-8193-be1ac573d3de",
-												"expiration": 1760350200297
-											}
-										}
-									}
-								}
-							}
-						}
-					},
-					"400": {
-						"description": "Bad request"
-					},
-					"401": {
-						"description": "Authentication required"
-					},
-					"500": {
-						"description": "Internal server error, XenServer/XCP-ng error"
-					}
-				},
-				"tags": [
-					"users"
-				],
-				"deprecated": true,
-				"security": [
-					{
-						"*": []
-					}
-				],
-				"parameters": [],
-				"requestBody": {
-					"required": true,
-					"content": {
-						"application/json": {
-							"schema": {
-								"properties": {
-									"expiresIn": {
-										"anyOf": [
-											{
-												"type": "string"
-											},
-											{
-												"type": "number",
-												"format": "double"
-											}
-										]
-									},
-									"description": {
-										"type": "string"
-									},
-									"client": {
-										"properties": {
-											"id": {
-												"type": "string"
-											}
-										},
-										"type": "object"
-									}
-								},
-								"type": "object"
-							},
-							"example": {
-								"client": {
-									"id": "my-fav-client"
-								},
-								"description": "token for CLI usage",
-								"expiresIn": "1 hour"
-							}
-						}
-					}
-				}
-			}
-		},
-		"/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",
+						"name": "markdown",
 						"required": false,
 						"schema": {
 							"type": "boolean"
@@ -22660,6 +23249,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -22860,6 +23457,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -22968,6 +23573,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -23086,6 +23699,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -23478,6 +24099,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -23658,6 +24287,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -24073,6 +24710,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -24168,6 +24813,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -24396,6 +25049,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -24574,6 +25235,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -24744,6 +25413,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -24893,6 +25570,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -27945,6 +28630,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -28148,6 +28841,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -28357,6 +29058,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -28543,6 +29252,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -28721,6 +29438,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -28829,6 +29554,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -28947,6 +29680,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -29040,6 +29781,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -29200,6 +29949,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -29360,6 +30117,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -29654,6 +30419,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -29869,6 +30642,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -29977,6 +30758,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -30095,6 +30884,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -30282,6 +31079,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -30436,6 +31241,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -37109,6 +37922,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -37377,6 +38198,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -37495,6 +38324,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -37966,6 +38803,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -38388,6 +39233,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -38506,6 +39359,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -38774,6 +39635,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -38935,6 +39804,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -39150,6 +40027,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -39323,6 +40208,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -39495,6 +40388,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -39654,6 +40555,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -39838,6 +40747,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -40088,6 +41005,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",
@@ -40271,6 +41196,14 @@
 							"type": "boolean"
 						}
 					},
+					{
+						"in": "query",
+						"name": "markdown",
+						"required": false,
+						"schema": {
+							"type": "boolean"
+						}
+					},
 					{
 						"in": "query",
 						"name": "filter",