From 704e8c23c296db229d5d61066b6274e84bf9feab Mon Sep 17 00:00:00 2001
From: Martin Machacek <machacek@edhouse.cz>
Date: Mon, 29 Dec 2025 17:55:00 +0100
Subject: [PATCH] Improves examples requests and responses

---
 .../beta/api/workbook-list-worksheets.md      |  8 ++++----
 api-reference/beta/api/worksheet-delete.md    |  4 ++--
 api-reference/beta/api/worksheet-get.md       |  8 ++++----
 api-reference/beta/api/worksheet-list.md      |  8 ++++----
 api-reference/beta/api/worksheet-update.md    | 20 +++++++++----------
 .../beta/api/worksheetcollection-add.md       | 14 ++++++-------
 .../v1.0/api/workbook-list-worksheets.md      |  8 ++++----
 api-reference/v1.0/api/worksheet-delete.md    |  4 ++--
 api-reference/v1.0/api/worksheet-get.md       |  8 ++++----
 api-reference/v1.0/api/worksheet-list.md      |  8 ++++----
 api-reference/v1.0/api/worksheet-update.md    | 20 +++++++++----------
 .../v1.0/api/worksheetcollection-add.md       | 12 +++++------
 12 files changed, 61 insertions(+), 61 deletions(-)

diff --git a/api-reference/beta/api/workbook-list-worksheets.md b/api-reference/beta/api/workbook-list-worksheets.md
index 46e2c4ac2d3..223d22ff119 100644
--- a/api-reference/beta/api/workbook-list-worksheets.md
+++ b/api-reference/beta/api/workbook-list-worksheets.md
@@ -99,10 +99,10 @@ Content-type: application/json
 {
   "value": [
     {
-      "id": "id-value",
-      "position": 99,
-      "name": "name-value",
-      "visibility": "visibility-value"
+      "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+      "position": 0,
+      "name": "Sheet1",
+      "visibility": "Visible"
     }
   ]
 }
diff --git a/api-reference/beta/api/worksheet-delete.md b/api-reference/beta/api/worksheet-delete.md
index fbe67a8c8cb..e404d0c4c80 100644
--- a/api-reference/beta/api/worksheet-delete.md
+++ b/api-reference/beta/api/worksheet-delete.md
@@ -41,7 +41,7 @@ DELETE /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}
 
 ## Response
 
-If successful, this method returns `200 OK` response code. It doesn't return anything in the response body.
+If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body.
 
 ## Example
 Here is an example of how to call this API.
@@ -89,7 +89,7 @@ The following example shows the response.
   "blockType": "response"
 } -->
 ```http
-HTTP/1.1 200 OK
+HTTP/1.1 204 No Content
 ```
 
 <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
diff --git a/api-reference/beta/api/worksheet-get.md b/api-reference/beta/api/worksheet-get.md
index 147e8383b4a..5e7dd64a711 100644
--- a/api-reference/beta/api/worksheet-get.md
+++ b/api-reference/beta/api/worksheet-get.md
@@ -96,10 +96,10 @@ HTTP/1.1 200 OK
 Content-type: application/json
 
 {
-  "id": "id-value",
-  "position": 99,
-  "name": "name-value",
-  "visibility": "visibility-value"
+  "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+  "position": 1,
+  "name": "Sheet1",
+  "visibility": "Visible"
 }
 ```
 
diff --git a/api-reference/beta/api/worksheet-list.md b/api-reference/beta/api/worksheet-list.md
index 7622270f556..9a2867688c1 100644
--- a/api-reference/beta/api/worksheet-list.md
+++ b/api-reference/beta/api/worksheet-list.md
@@ -99,10 +99,10 @@ Content-type: application/json
 {
   "value": [
     {
-      "id": "id-value",
-      "position": 99,
-      "name": "name-value",
-      "visibility": "visibility-value"
+      "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+      "position": 0,
+      "name": "Sheet1",
+      "visibility": "Visible"
     }
   ]
 }
diff --git a/api-reference/beta/api/worksheet-update.md b/api-reference/beta/api/worksheet-update.md
index c310864a5ca..82e48b5855d 100644
--- a/api-reference/beta/api/worksheet-update.md
+++ b/api-reference/beta/api/worksheet-update.md
@@ -41,9 +41,9 @@ In the request body, supply the values for relevant fields that should be update
 
 | Property	   | Type	|Description|
 |:---------------|:--------|:----------|
-|name|string|The display name of the worksheet.|
-|position|int|The zero-based position of the worksheet within the workbook.|
-|visibility|string|The Visibility of the worksheet. The possible values are: `Visible`, `Hidden`, `VeryHidden`.|
+|name|string|The display name of the worksheet. Optional.|
+|position|int|The zero-based position of the worksheet within the workbook. Optional.|
+|visibility|string|The Visibility of the worksheet. Optional. The possible values are: `Visible`, `Hidden`, `VeryHidden`.|
 
 ## Response
 
@@ -62,9 +62,9 @@ PATCH https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{
 Content-type: application/json
 
 {
-  "position": 99,
-  "name": "name-value",
-  "visibility": "visibility-value"
+  "position": 0,
+  "name": "Sheet2",
+  "visibility": "Hidden"
 }
 ```
 
@@ -106,10 +106,10 @@ HTTP/1.1 200 OK
 Content-type: application/json
 
 {
-  "id": "id-value",
-  "position": 99,
-  "name": "name-value",
-  "visibility": "visibility-value"
+  "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+  "position": 0,
+  "name": "Sheet2",
+  "visibility": "Hidden"
 }
 ```
 
diff --git a/api-reference/beta/api/worksheetcollection-add.md b/api-reference/beta/api/worksheetcollection-add.md
index 63fc0b85120..5a39a0b261e 100644
--- a/api-reference/beta/api/worksheetcollection-add.md
+++ b/api-reference/beta/api/worksheetcollection-add.md
@@ -46,7 +46,7 @@ In the request body, provide a JSON object with the following parameters.
 
 ## Response
 
-If successful, this method returns `200 OK` response code and [workbookWorksheet](../resources/workbookworksheet.md) object in the response body.
+If successful, this method returns `201 Created` response code and [workbookWorksheet](../resources/workbookworksheet.md) object in the response body.
 
 ## Examples
 
@@ -63,7 +63,7 @@ POST https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/ad
 Content-type: application/json
 
 {
-  "name": "name-value"
+  "name": "Sheet1"
 }
 ```
 
@@ -103,14 +103,14 @@ The following example shows the response.
   "@odata.type": "microsoft.graph.workbookWorksheet"
 } -->
 ```http
-HTTP/1.1 200 OK
+HTTP/1.1 201 Created
 Content-type: application/json
 
 {
-  "id": "id-value",
-  "position": 99,
-  "name": "name-value",
-  "visibility": "visibility-value"
+  "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+  "position": 1,
+  "name": "Sheet1",
+  "visibility": "Visible"
 }
 ```
 
diff --git a/api-reference/v1.0/api/workbook-list-worksheets.md b/api-reference/v1.0/api/workbook-list-worksheets.md
index 76509f74f06..a951fcbe9d2 100644
--- a/api-reference/v1.0/api/workbook-list-worksheets.md
+++ b/api-reference/v1.0/api/workbook-list-worksheets.md
@@ -97,10 +97,10 @@ Content-type: application/json
 {
   "value": [
     {
-      "id": "id-value",
-      "position": 99,
-      "name": "name-value",
-      "visibility": "visibility-value"
+      "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+      "position": 0,
+      "name": "Sheet1",
+      "visibility": "Visible"
     }
   ]
 }
diff --git a/api-reference/v1.0/api/worksheet-delete.md b/api-reference/v1.0/api/worksheet-delete.md
index 649911e6135..85701739f4b 100644
--- a/api-reference/v1.0/api/worksheet-delete.md
+++ b/api-reference/v1.0/api/worksheet-delete.md
@@ -39,7 +39,7 @@ DELETE /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}
 
 ## Response
 
-If successful, this method returns `200 OK` response code. It doesn't return anything in the response body.
+If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body.
 
 ## Example
 Here is an example of how to call this API.
@@ -88,7 +88,7 @@ The following example shows the response.
   "truncated": true
 } -->
 ```http
-HTTP/1.1 200 OK
+HTTP/1.1 204 No Content
 ```
 
 <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
diff --git a/api-reference/v1.0/api/worksheet-get.md b/api-reference/v1.0/api/worksheet-get.md
index eb70c5a26a9..479e7f0cb8c 100644
--- a/api-reference/v1.0/api/worksheet-get.md
+++ b/api-reference/v1.0/api/worksheet-get.md
@@ -94,10 +94,10 @@ HTTP/1.1 200 OK
 Content-type: application/json
 
 {
-  "id": "id-value",
-  "position": 99,
-  "name": "name-value",
-  "visibility": "visibility-value"
+  "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+  "position": 1,
+  "name": "Sheet1",
+  "visibility": "Visible"
 }
 ```
 
diff --git a/api-reference/v1.0/api/worksheet-list.md b/api-reference/v1.0/api/worksheet-list.md
index 66a7dbe5f40..2a0b949a59e 100644
--- a/api-reference/v1.0/api/worksheet-list.md
+++ b/api-reference/v1.0/api/worksheet-list.md
@@ -97,10 +97,10 @@ Content-type: application/json
 {
   "value": [
     {
-      "id": "id-value",
-      "position": 99,
-      "name": "name-value",
-      "visibility": "visibility-value"
+      "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+      "position": 0,
+      "name": "Sheet1",
+      "visibility": "Visible"
     }
   ]
 }
diff --git a/api-reference/v1.0/api/worksheet-update.md b/api-reference/v1.0/api/worksheet-update.md
index 41eb8290473..d9b8e0258e5 100644
--- a/api-reference/v1.0/api/worksheet-update.md
+++ b/api-reference/v1.0/api/worksheet-update.md
@@ -41,9 +41,9 @@ In the request body, supply the values for relevant fields that should be update
 
 | Property       | Type    |Description|
 |:---------------|:--------|:----------|
-|name|string|The display name of the worksheet.|
-|position|int|The zero-based position of the worksheet within the workbook.|
-|visibility|string|The Visibility of the worksheet. The possible values are: `Visible`, `Hidden`, `VeryHidden`.|
+|name|string|The display name of the worksheet. Optional.|
+|position|int|The zero-based position of the worksheet within the workbook. Optional.|
+|visibility|string|The Visibility of the worksheet. Optional. The possible values are: `Visible`, `Hidden`, `VeryHidden`.|
 
 ## Response
 
@@ -62,9 +62,9 @@ PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{
 Content-type: application/json
 
 {
-  "position": 99,
-  "name": "name-value",
-  "visibility": "visibility-value"
+  "position": 0,
+  "name": "Sheet2",
+  "visibility": "Hidden"
 }
 ```
 
@@ -106,10 +106,10 @@ HTTP/1.1 200 OK
 Content-type: application/json
 
 {
-  "id": "id-value",
-  "position": 99,
-  "name": "name-value",
-  "visibility": "visibility-value"
+  "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+  "position": 0,
+  "name": "Sheet2",
+  "visibility": "Hidden"
 }
 ```
 
diff --git a/api-reference/v1.0/api/worksheetcollection-add.md b/api-reference/v1.0/api/worksheetcollection-add.md
index 759865cb941..90a871a1352 100644
--- a/api-reference/v1.0/api/worksheetcollection-add.md
+++ b/api-reference/v1.0/api/worksheetcollection-add.md
@@ -61,7 +61,7 @@ POST https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/ad
 Content-type: application/json
 
 {
-  "name": "name-value"
+  "name": "Sheet1"
 }
 ```
 
@@ -101,14 +101,14 @@ The following example shows the response.
   "@odata.type": "microsoft.graph.workbookWorksheet"
 } -->
 ```http
-HTTP/1.1 200 OK
+HTTP/1.1 201 Created
 Content-type: application/json
 
 {
-  "id": "id-value",
-  "position": 99,
-  "name": "name-value",
-  "visibility": "visibility-value"
+  "id": "{FC034FA8-F8CC-4D24-9C0A-02A81B7792A0}",
+  "position": 1,
+  "name": "Sheet1",
+  "visibility": "Visible"
 }
 ```