From 0fcc424ff218fb63ef4c7edb4c69857d8a9b8a4d Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 14:00:05 +0200
Subject: [PATCH 01/45] Update description.md

---
 docs/srvctl-account-balance/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-account-balance/description.md b/docs/srvctl-account-balance/description.md
index 2e7b584..3527400 100644
--- a/docs/srvctl-account-balance/description.md
+++ b/docs/srvctl-account-balance/description.md
@@ -1 +1 @@
-This command provides account balance information.
+This command provides current account balance and next invoice total due in the account currency.

From 8b0dcb7bbe4b5df329ae8e4c2da946c7078b47b3 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 14:09:18 +0200
Subject: [PATCH 02/45] Update examples.md

---
 docs/srvctl-cloud-backups/examples.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/srvctl-cloud-backups/examples.md b/docs/srvctl-cloud-backups/examples.md
index 0af772c..a046b54 100644
--- a/docs/srvctl-cloud-backups/examples.md
+++ b/docs/srvctl-cloud-backups/examples.md
@@ -2,6 +2,7 @@ A command to list all cloud backups for the account:
 
 ```
 srvctl cloud-backups list
+```
 
 A command to get information for a specific cloud backup:
 

From 782dbbf0733c4fc011a5bc68d4840822db19dbd5 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 14:19:26 +0200
Subject: [PATCH 03/45] Update description.md

---
 docs/srvctl-cloud-instances-add/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-add/description.md b/docs/srvctl-cloud-instances-add/description.md
index 31936e3..3b4f86b 100644
--- a/docs/srvctl-cloud-instances-add/description.md
+++ b/docs/srvctl-cloud-instances-add/description.md
@@ -1 +1 @@
-A command to create a new cloud instance. Parameters should be passed via the `-i` or `--input` flag pointing to a JSON file or stdin (`--input -`).
+A command to create a new cloud instance. Parameters should be passed via the `-i` or `--input` flag pointing to a JSON file or stdin (`--input -`) for standard input in terminal. Use the `--skeleton` flag to see an example of how to describe a JSON with parameters.

From e40b4c6e2ff5bd4ef5087444c30d4edc451deb04 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 14:22:14 +0200
Subject: [PATCH 04/45] Update description.md

---
 docs/srvctl-cloud-instances-add/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-add/description.md b/docs/srvctl-cloud-instances-add/description.md
index 3b4f86b..f98ea0b 100644
--- a/docs/srvctl-cloud-instances-add/description.md
+++ b/docs/srvctl-cloud-instances-add/description.md
@@ -1 +1 @@
-A command to create a new cloud instance. Parameters should be passed via the `-i` or `--input` flag pointing to a JSON file or stdin (`--input -`) for standard input in terminal. Use the `--skeleton` flag to see an example of how to describe a JSON with parameters.
+A command to create a new cloud instance. Parameters should be passed via the `-i` or `--input` flag pointing to a JSON file or stdin (`--input -`) for standard input in terminal. Use the `--skeleton` flag to see an example of how to describe a JSON with parameters. This JSON structure repeats the request body of the [Create instance PAPI request](https://developers.servers.com/api-documentation/v1/#tag/Cloud-Instance/operation/CreateACloudInstance).

From 08127d9796f9d5ad01a8727d17b528b38a4772fd Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 14:58:49 +0200
Subject: [PATCH 05/45] Update description.md

---
 docs/srvctl-cloud-instances-reinstall/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-reinstall/description.md b/docs/srvctl-cloud-instances-reinstall/description.md
index 68fc9e2..ae6afc7 100644
--- a/docs/srvctl-cloud-instances-reinstall/description.md
+++ b/docs/srvctl-cloud-instances-reinstall/description.md
@@ -1 +1 @@
-This command reinstalls the operating system on the selected cloud instance. The `--image-id` flag is required.
+This command reinstalls the operating system on the selected cloud instance. The `--image-id` flag is required. Use the [List images PAPI request](https://developers.servers.com/api-documentation/v1/#tag/Cloud-Image/operation/ListCloudImages) to get IDs.

From fb0e64079001ab920de16b592af5a771d05af262 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 15:14:00 +0200
Subject: [PATCH 06/45] Update description.md

---
 docs/srvctl-cloud-instances-upgrade-approve/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-upgrade-approve/description.md b/docs/srvctl-cloud-instances-upgrade-approve/description.md
index a8001fb..6bfc783 100644
--- a/docs/srvctl-cloud-instances-upgrade-approve/description.md
+++ b/docs/srvctl-cloud-instances-upgrade-approve/description.md
@@ -1 +1 @@
-This command approves a pending upgrade for the selected cloud instance.
+This command approves a pending upgrade for the selected cloud instance. It will be automatically approved after 72 hours from the upgrade request.

From c80d64f8ed7ea36437d23f32ae1c2f51d5da0d05 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 15:15:08 +0200
Subject: [PATCH 07/45] Update description.md

---
 docs/srvctl-cloud-instances-upgrade-approve/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-upgrade-approve/description.md b/docs/srvctl-cloud-instances-upgrade-approve/description.md
index 6bfc783..2f09262 100644
--- a/docs/srvctl-cloud-instances-upgrade-approve/description.md
+++ b/docs/srvctl-cloud-instances-upgrade-approve/description.md
@@ -1 +1 @@
-This command approves a pending upgrade for the selected cloud instance. It will be automatically approved after 72 hours from the upgrade request.
+This command approves a pending upgrade for the selected cloud instance. It will be automatically approved after 72 hours from the upgrade request. After approval, upgrade can't be reverted.

From 990a02798766131bc669d499e4534c0a00a4ec03 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 15:16:42 +0200
Subject: [PATCH 08/45] Update description.md

---
 docs/srvctl-cloud-instances-upgrade/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-upgrade/description.md b/docs/srvctl-cloud-instances-upgrade/description.md
index 0914137..41b0634 100644
--- a/docs/srvctl-cloud-instances-upgrade/description.md
+++ b/docs/srvctl-cloud-instances-upgrade/description.md
@@ -1 +1 @@
-This command upgrades the selected cloud instance to a new flavor.
+This command upgrades the selected cloud instance to a new flavor. You are able to revert upgrade to the previous configuration or approve the changes within 72 hours. After 72 hours, it will be automatically approved.

From 7d71d38540aa7939b0b1c77b515eff5010762bf6 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 15:18:08 +0200
Subject: [PATCH 09/45] Update description.md

---
 docs/srvctl-cloud-instances-upgrade/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-upgrade/description.md b/docs/srvctl-cloud-instances-upgrade/description.md
index 41b0634..df93a37 100644
--- a/docs/srvctl-cloud-instances-upgrade/description.md
+++ b/docs/srvctl-cloud-instances-upgrade/description.md
@@ -1 +1 @@
-This command upgrades the selected cloud instance to a new flavor. You are able to revert upgrade to the previous configuration or approve the changes within 72 hours. After 72 hours, it will be automatically approved.
+This command upgrades the selected cloud instance to a new flavor. You are able to revert upgrade to the previous configuration or approve the changes within 72 hours. After 72 hours, it will be automatically approved. Use the [List cloud flavors PAPI request](https://developers.servers.com/api-documentation/v1/#tag/Cloud-Flavor/operation/ListCloudFlavors) to list their IDs.

From ba39238bd3de9dc3cefe5ab0b585e4dc21b2618c Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 15:27:13 +0200
Subject: [PATCH 10/45] Update description.md

---
 docs/srvctl-cloud-instances-reinstall/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-reinstall/description.md b/docs/srvctl-cloud-instances-reinstall/description.md
index ae6afc7..68fc9e2 100644
--- a/docs/srvctl-cloud-instances-reinstall/description.md
+++ b/docs/srvctl-cloud-instances-reinstall/description.md
@@ -1 +1 @@
-This command reinstalls the operating system on the selected cloud instance. The `--image-id` flag is required. Use the [List images PAPI request](https://developers.servers.com/api-documentation/v1/#tag/Cloud-Image/operation/ListCloudImages) to get IDs.
+This command reinstalls the operating system on the selected cloud instance. The `--image-id` flag is required.

From 71b24a7eb8f8a38563053e1fca5caebb0492b77c Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 15:28:55 +0200
Subject: [PATCH 11/45] Update description.md

---
 docs/srvctl-cloud-instances-upgrade/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-upgrade/description.md b/docs/srvctl-cloud-instances-upgrade/description.md
index df93a37..41b0634 100644
--- a/docs/srvctl-cloud-instances-upgrade/description.md
+++ b/docs/srvctl-cloud-instances-upgrade/description.md
@@ -1 +1 @@
-This command upgrades the selected cloud instance to a new flavor. You are able to revert upgrade to the previous configuration or approve the changes within 72 hours. After 72 hours, it will be automatically approved. Use the [List cloud flavors PAPI request](https://developers.servers.com/api-documentation/v1/#tag/Cloud-Flavor/operation/ListCloudFlavors) to list their IDs.
+This command upgrades the selected cloud instance to a new flavor. You are able to revert upgrade to the previous configuration or approve the changes within 72 hours. After 72 hours, it will be automatically approved.

From ff57faa8d19c42b62f6fb1c602170cc96c4a52ce Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 15:29:58 +0200
Subject: [PATCH 12/45] Update description.md

---
 docs/srvctl-cloud-regions-add-snapshot/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-regions-add-snapshot/description.md b/docs/srvctl-cloud-regions-add-snapshot/description.md
index 83c5b61..61f6d73 100644
--- a/docs/srvctl-cloud-regions-add-snapshot/description.md
+++ b/docs/srvctl-cloud-regions-add-snapshot/description.md
@@ -1 +1 @@
-This command creates a new snapshot for the selected cloud region. The `--name` and `--instance-id` flags are required.
+This command creates a snapshot for the selected instance within a cloud region. The `--name` and `--instance-id` flags are required.

From 47535b6ba6e0e7a11a6ed225684a7899ee5abdb6 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 16:07:54 +0200
Subject: [PATCH 13/45] Update description.md

---
 docs/srvctl-cloud-regions-get-credentials/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-regions-get-credentials/description.md b/docs/srvctl-cloud-regions-get-credentials/description.md
index 388f419..b9d1d98 100644
--- a/docs/srvctl-cloud-regions-get-credentials/description.md
+++ b/docs/srvctl-cloud-regions-get-credentials/description.md
@@ -1 +1 @@
-This command provides credentials for the selected cloud region.
+This command provides credentials for the selected cloud region. More details in [Public API documentation](https://developers.servers.com/api-documentation/v1/#tag/Cloud-Credentials).

From a51094745f0ee5e5741f580873f286cb0b055065 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 16:14:13 +0200
Subject: [PATCH 14/45] Update examples.md

---
 docs/srvctl-cloud-regions-list-snapshots/examples.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docs/srvctl-cloud-regions-list-snapshots/examples.md b/docs/srvctl-cloud-regions-list-snapshots/examples.md
index 780ab45..b62384b 100644
--- a/docs/srvctl-cloud-regions-list-snapshots/examples.md
+++ b/docs/srvctl-cloud-regions-list-snapshots/examples.md
@@ -9,9 +9,3 @@ A command to filter snapshots by instance:
 ```
 srvctl cloud-regions list-snapshots 42 --instance-id ex4mp1eID
 ```
-
-A command to filter snapshots by backup status:
-
-```
-srvctl cloud-regions list-snapshots 42 --is-backup
-```

From 2057d53cd6833cc48e3b0c0ae6ce71493c62ad34 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 16:16:13 +0200
Subject: [PATCH 15/45] Update description.md

---
 docs/srvctl-cloud-regions-list/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-regions-list/description.md b/docs/srvctl-cloud-regions-list/description.md
index f5e9f95..cfb90dc 100644
--- a/docs/srvctl-cloud-regions-list/description.md
+++ b/docs/srvctl-cloud-regions-list/description.md
@@ -1 +1 @@
-This command lists available cloud regions. Use `--help` to see available flags.
+This command lists cloud regions. Use `--help` to see available flags.

From 2ba4b729d9291f4add447a601026b895a1562d8b Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 16:20:51 +0200
Subject: [PATCH 16/45] Update examples.md

---
 docs/srvctl-cloud-regions/examples.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docs/srvctl-cloud-regions/examples.md b/docs/srvctl-cloud-regions/examples.md
index 2f46f1f..055a838 100644
--- a/docs/srvctl-cloud-regions/examples.md
+++ b/docs/srvctl-cloud-regions/examples.md
@@ -3,9 +3,3 @@ A command to list all available cloud regions:
 ```
 srvctl cloud-regions list
 ```
-
-A command to get credentials for a specific cloud region:
-
-```
-srvctl cloud-regions get-credentials 42
-```

From e607fa9220f3cf050ba3517cd13e852f852bd38f Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 16:31:17 +0200
Subject: [PATCH 17/45] Update examples.md

---
 docs/srvctl-cloud-volumes-add/examples.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docs/srvctl-cloud-volumes-add/examples.md b/docs/srvctl-cloud-volumes-add/examples.md
index 9f76688..b2874e0 100644
--- a/docs/srvctl-cloud-volumes-add/examples.md
+++ b/docs/srvctl-cloud-volumes-add/examples.md
@@ -1,9 +1,3 @@
-A command to show the skeleton JSON structure required to create a cloud volume:
-
-```
-srvctl cloud-volumes add --skeleton
-```
-
 An example of a command for a file in the same directory with srvctl:
 
 ```

From 68d3bfd2e6f3264da596e638ad882c787bc5f3ed Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 16:37:29 +0200
Subject: [PATCH 18/45] Update examples.md

---
 docs/srvctl-drive-models/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-drive-models/examples.md b/docs/srvctl-drive-models/examples.md
index 56ee790..c912b1b 100644
--- a/docs/srvctl-drive-models/examples.md
+++ b/docs/srvctl-drive-models/examples.md
@@ -1,5 +1,5 @@
 A command to list available drive models:
 
 ```
-srvctl drive-models --help
+srvctl drive-models list
 ```

From 8e548cf6159abbb8bc4f89df3059cba5c8f704a8 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Tue, 24 Feb 2026 16:49:58 +0200
Subject: [PATCH 19/45] Update examples.md

---
 docs/srvctl-k8s-list-nodes/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-k8s-list-nodes/examples.md b/docs/srvctl-k8s-list-nodes/examples.md
index b82024e..62d8a35 100644
--- a/docs/srvctl-k8s-list-nodes/examples.md
+++ b/docs/srvctl-k8s-list-nodes/examples.md
@@ -13,5 +13,5 @@ srvctl k8s list-nodes ex4mp1eClusterID --search-pattern "worker"
 A command to filter nodes by label:
 
 ```
-srvctl k8s list-nodes ex4mp1eClusterID --label-selector "role=worker"
+srvctl k8s list-nodes ex4mp1eClusterID --label-selector "team=devops"
 ```

From df5a2f4a0b9ea505c92ba79ea403bea4740cda03 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 11:01:01 +0200
Subject: [PATCH 20/45] Update examples.md

---
 docs/srvctl-k8s-list/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-k8s-list/examples.md b/docs/srvctl-k8s-list/examples.md
index 02cf826..0e5088f 100644
--- a/docs/srvctl-k8s-list/examples.md
+++ b/docs/srvctl-k8s-list/examples.md
@@ -7,7 +7,7 @@ srvctl k8s list
 A command to filter Kubernetes clusters by location:
 
 ```
-srvctl k8s list --location-id "LON1"
+srvctl k8s list --location-id 1
 ```
 
 A command to filter Kubernetes clusters by label:

From f75231fd9ed9f52c17f60cf48a717a98217b800e Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 11:07:23 +0200
Subject: [PATCH 21/45] Update examples.md

---
 docs/srvctl-l2-segments-list-groups/examples.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/srvctl-l2-segments-list-groups/examples.md b/docs/srvctl-l2-segments-list-groups/examples.md
index 84088b1..603e39e 100644
--- a/docs/srvctl-l2-segments-list-groups/examples.md
+++ b/docs/srvctl-l2-segments-list-groups/examples.md
@@ -1,7 +1,8 @@
 A command to list all L2 segment location groups:
 
 ```
-srvctl l2-segments list-groups```
+srvctl l2-segments list-groups
+```
 
 A command to filter location groups by type:
 

From 6e531d9917e0bb6a3af39dda6caf96fa6604ba34 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 11:10:00 +0200
Subject: [PATCH 22/45] Update description.md

---
 docs/srvctl-l2-segments-add/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-l2-segments-add/description.md b/docs/srvctl-l2-segments-add/description.md
index 8dc1c00..34ed6e3 100644
--- a/docs/srvctl-l2-segments-add/description.md
+++ b/docs/srvctl-l2-segments-add/description.md
@@ -1,5 +1,5 @@
 A command to create a new L2 segment. It allows to pass parameters in two ways:
 
-- Input - segment parameters are described in a file, a path to the file is specified via the `-i` or `--input` flag. The path can be absolute or relative to the srvctl file. Parameters should be described as a request body of the Public API request. There is also an option to use standard input (stdin) when specifying the flag this way: `--input -`
+- Input - segment parameters are described in a file, a path to the file is specified via the `-i` or `--input` flag. The path can be absolute or relative to the srvctl file. Parameters should be described as a request body of the [Public API request](https://developers.servers.com/api-documentation/v1/#tag/L2-Segment/operation/CreateAnL2Segment). There is also an option to use standard input (stdin) when specifying the flag this way: `--input -`
 
 - Flags - parameters are specified via flags inside the command. The `--type` and `--member` flags are required. Members are specified in `id=<string>,mode=<native|trunk>` format and can be repeated for multiple members.

From b5248a5ac38049de27bf9975af5088fd1e953961 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 11:23:19 +0200
Subject: [PATCH 23/45] Update examples.md

---
 docs/srvctl-l2-segments-update-networks/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-l2-segments-update-networks/examples.md b/docs/srvctl-l2-segments-update-networks/examples.md
index fdce2e8..b14ed9d 100644
--- a/docs/srvctl-l2-segments-update-networks/examples.md
+++ b/docs/srvctl-l2-segments-update-networks/examples.md
@@ -1,7 +1,7 @@
 A command to show the skeleton JSON structure required to update L2 segment networks:
 
 ```
-srvctl l2-segments update-networks --skeleton
+srvctl l2-segments update-networks ex4mp1eID --skeleton
 ```
 
 A command to update networks for the L2 segment with the "ex4mp1eID" ID using an input file:

From c2a907039b8b98117b22eb3bc202adb68c25fa9d Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 11:25:29 +0200
Subject: [PATCH 24/45] Update examples.md

---
 docs/srvctl-l2-segments-update/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-l2-segments-update/examples.md b/docs/srvctl-l2-segments-update/examples.md
index 613c17e..3ebd88e 100644
--- a/docs/srvctl-l2-segments-update/examples.md
+++ b/docs/srvctl-l2-segments-update/examples.md
@@ -1,7 +1,7 @@
 A command to show the skeleton JSON structure required to update an L2 segment:
 
 ```
-srvctl l2-segments update --skeleton
+srvctl l2-segments update ex4mp1eID --skeleton
 ```
 
 A command to update the L2 segment with the "ex4mp1eID" ID using an input file:

From 6d4e7349816ddc05ad0154e58c0dfff4626ce7ea Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 11:26:22 +0200
Subject: [PATCH 25/45] Update description.md

---
 docs/srvctl-l2-segments-update/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-l2-segments-update/description.md b/docs/srvctl-l2-segments-update/description.md
index 9a55e56..37c8c3c 100644
--- a/docs/srvctl-l2-segments-update/description.md
+++ b/docs/srvctl-l2-segments-update/description.md
@@ -1 +1 @@
-This command updates an L2 segment by id. Parameters should be passed via the `-i` or `--input` flag pointing to a JSON file or stdin (`--input -`).
+This command updates an L2 segment by id. Parameters should be passed via the `-i` or `--input` flag pointing to a JSON file or stdin (`--input -`). Use the `--skeleton` flag to see the JSON file structure.

From 580783e9f050930ffdf6b6b81e3a0415fc07d265 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:02:13 +0200
Subject: [PATCH 26/45] Update description.md

---
 docs/srvctl-lb-l4-add/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-lb-l4-add/description.md b/docs/srvctl-lb-l4-add/description.md
index d221167..faf85c2 100644
--- a/docs/srvctl-lb-l4-add/description.md
+++ b/docs/srvctl-lb-l4-add/description.md
@@ -1 +1 @@
-A command to create a new L4 load balancer.
+A command to create a new L4 load balancer. LB parameters should be described in a file, a path to the file is specified via the `-i` or `--input` flag. The path can be absolute or relative to the srvctl file. There is also an option to use standard input (stdin) when specifying the flag this way: `--input -`. Use the `--skeleton` flag to see JSON structure of the file.

From 148d86f32c90e46e6ef5daf7f9c2a2400508c1ba Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:03:35 +0200
Subject: [PATCH 27/45] Update examples.md

---
 docs/srvctl-lb-l4-add/examples.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docs/srvctl-lb-l4-add/examples.md b/docs/srvctl-lb-l4-add/examples.md
index 5d2f33e..30e42f1 100644
--- a/docs/srvctl-lb-l4-add/examples.md
+++ b/docs/srvctl-lb-l4-add/examples.md
@@ -10,12 +10,6 @@ A command to create a new L4 load balancer using a JSON file:
 srvctl lb l4 add --input /path/to/input.json
 ```
 
-A command to create a new L4 load balancer using stdin:
-
-```
-cat input.json | srvctl lb l4 add --input -
-```
-
 JSON structure example:
 
 ```json

From 6aa5e4e0dc036e7e25c0f8297f159dfa0dd1b5c9 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:05:02 +0200
Subject: [PATCH 28/45] Update examples.md

---
 docs/srvctl-lb-l4-list/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-lb-l4-list/examples.md b/docs/srvctl-lb-l4-list/examples.md
index c412857..dd91e70 100644
--- a/docs/srvctl-lb-l4-list/examples.md
+++ b/docs/srvctl-lb-l4-list/examples.md
@@ -7,7 +7,7 @@ srvctl lb l4 list
 A command to filter L4 load balancers by location:
 
 ```
-srvctl lb l4 list --location-id "LON1"
+srvctl lb l4 list --location-id 5
 ```
 
 A command to filter L4 load balancers by cluster:

From bae34340ac717553f63b656f5aaf8aa4f1b76076 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:07:06 +0200
Subject: [PATCH 29/45] Update description.md

---
 docs/srvctl-lb-l4-update/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-lb-l4-update/description.md b/docs/srvctl-lb-l4-update/description.md
index 49bc579..a889741 100644
--- a/docs/srvctl-lb-l4-update/description.md
+++ b/docs/srvctl-lb-l4-update/description.md
@@ -1 +1 @@
-This command updates the selected L4 load balancer.
+This command updates the selected L4 load balancer using a JSON file specified via the `--input` flag. Use the `--skeleton` flag to see the JSON structure.

From 83a5f0dd667dbfa55ff350ec475ed8b0e32b9dbe Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:07:43 +0200
Subject: [PATCH 30/45] Update examples.md

---
 docs/srvctl-lb-l4-update/examples.md | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/docs/srvctl-lb-l4-update/examples.md b/docs/srvctl-lb-l4-update/examples.md
index e0bd44d..5b3af31 100644
--- a/docs/srvctl-lb-l4-update/examples.md
+++ b/docs/srvctl-lb-l4-update/examples.md
@@ -1,7 +1,7 @@
 A command to get the JSON structure required to update an L4 load balancer:
 
 ```
-srvctl lb l4 update --skeleton
+srvctl lb l4 update ex4mp1eID --skeleton
 ```
 
 A command to update the L4 load balancer with the "ex4mp1eID" ID using a JSON file:
@@ -10,12 +10,6 @@ A command to update the L4 load balancer with the "ex4mp1eID" ID using a JSON fi
 srvctl lb l4 update ex4mp1eID --input /path/to/input.json
 ```
 
-A command to update the L4 load balancer using stdin:
-
-```
-cat input.json | srvctl lb l4 update ex4mp1eID --input -
-```
-
 JSON structure example:
 
 ```json

From e2a93f6742f2aaf5491e139b6af0c7e775e64893 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:11:09 +0200
Subject: [PATCH 31/45] Update description.md

---
 docs/srvctl-lb-l7-add/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-lb-l7-add/description.md b/docs/srvctl-lb-l7-add/description.md
index 3889cb1..b6de553 100644
--- a/docs/srvctl-lb-l7-add/description.md
+++ b/docs/srvctl-lb-l7-add/description.md
@@ -1 +1 @@
-A command to create a new L7 load balancer.
+A command to create a new L7 load balancer. LB parameters should be described in a file, a path to the file is specified via the `-i` or `--input` flag. The path can be absolute or relative to the srvctl file. There is also an option to use standard input (stdin) when specifying the flag this way: `--input -`. Use the `--skeleton` flag to see JSON structure of the file.

From 465c2dce9dfa550471480ab979b98ae98901955f Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:13:36 +0200
Subject: [PATCH 32/45] Update examples.md

---
 docs/srvctl-lb-l7-add/examples.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docs/srvctl-lb-l7-add/examples.md b/docs/srvctl-lb-l7-add/examples.md
index fa963e5..33319ed 100644
--- a/docs/srvctl-lb-l7-add/examples.md
+++ b/docs/srvctl-lb-l7-add/examples.md
@@ -10,12 +10,6 @@ A command to create a new L7 load balancer using a JSON file:
 srvctl lb l7 add --input /path/to/input.json
 ```
 
-A command to create a new L7 load balancer using stdin:
-
-```
-cat input.json | srvctl lb l7 add --input -
-```
-
 JSON structure example:
 
 ```json

From ab293d497812cc555fc7677787a5e594d9486c33 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:14:46 +0200
Subject: [PATCH 33/45] Update examples.md

---
 docs/srvctl-lb-l7-list/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-lb-l7-list/examples.md b/docs/srvctl-lb-l7-list/examples.md
index a79d23d..62bc32a 100644
--- a/docs/srvctl-lb-l7-list/examples.md
+++ b/docs/srvctl-lb-l7-list/examples.md
@@ -13,7 +13,7 @@ srvctl lb l7 list --all
 A command to filter L7 load balancers by location:
 
 ```
-srvctl lb l7 list --location-id "LON1"
+srvctl lb l7 list --location-id 5
 ```
 
 A command to filter L7 load balancers by cluster:

From 3b5cdb2d734afbfc16dec10bdf66be0f7bd079aa Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:16:07 +0200
Subject: [PATCH 34/45] Update description.md

---
 docs/srvctl-lb-l7-update/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-lb-l7-update/description.md b/docs/srvctl-lb-l7-update/description.md
index 106fa11..1b2bc84 100644
--- a/docs/srvctl-lb-l7-update/description.md
+++ b/docs/srvctl-lb-l7-update/description.md
@@ -1 +1 @@
-This command updates the selected L7 load balancer.
+This command updates the selected L7 load balancer using a JSON file specified via the `--input` flag. Use the `--skeleton` flag to see the JSON structure.

From 48ba437299ee45d0b641f424abf9079a58a44c98 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:16:39 +0200
Subject: [PATCH 35/45] Update examples.md

---
 docs/srvctl-lb-l7-update/examples.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docs/srvctl-lb-l7-update/examples.md b/docs/srvctl-lb-l7-update/examples.md
index 0f71dff..69f36af 100644
--- a/docs/srvctl-lb-l7-update/examples.md
+++ b/docs/srvctl-lb-l7-update/examples.md
@@ -10,12 +10,6 @@ A command to update the L7 load balancer with the "ex4mp1eID" ID using a JSON fi
 srvctl lb l7 update ex4mp1eID --input /path/to/input.json
 ```
 
-A command to update the L7 load balancer using stdin:
-
-```
-cat input.json | srvctl lb l7 update ex4mp1eID --input -
-```
-
 JSON structure example:
 
 ```json

From 42530258509d77640c23530b6c4ccc1f8267361f Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:17:42 +0200
Subject: [PATCH 36/45] Update examples.md

---
 docs/srvctl-lb-list/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-lb-list/examples.md b/docs/srvctl-lb-list/examples.md
index 08ff33d..452afa4 100644
--- a/docs/srvctl-lb-list/examples.md
+++ b/docs/srvctl-lb-list/examples.md
@@ -13,7 +13,7 @@ srvctl lb list --all
 A command to filter load balancers by location:
 
 ```
-srvctl lb list --location-id "LON1"
+srvctl lb list --location-id 5
 ```
 
 A command to filter load balancers by cluster:

From 1ad1494ec0e21965f5b5e5b2ec09ecbb81e0f852 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 14:19:29 +0200
Subject: [PATCH 37/45] Update description.md

---
 docs/srvctl-lb/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-lb/description.md b/docs/srvctl-lb/description.md
index ccd085c..2d7b77a 100644
--- a/docs/srvctl-lb/description.md
+++ b/docs/srvctl-lb/description.md
@@ -1 +1 @@
-This command allows to manage load balancers of different types (l4, l7).
+This command allows to manage load balancers. Select the specific type (`l4` or `l7`) to see available operations for each one.

From 6600d37be4242613c8e6a35c7f5d2984a012d788 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 15:17:25 +0200
Subject: [PATCH 38/45] Update examples.md

---
 docs/srvctl-network-pools-list/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-network-pools-list/examples.md b/docs/srvctl-network-pools-list/examples.md
index 15d0647..0c54ac2 100644
--- a/docs/srvctl-network-pools-list/examples.md
+++ b/docs/srvctl-network-pools-list/examples.md
@@ -13,7 +13,7 @@ srvctl network-pools list --all
 A command to filter network pools by location:
 
 ```
-srvctl network-pools list --location-id "LON1"
+srvctl network-pools list --location-id 42
 ```
 
 A command to filter network pools by type:

From 0d678899ade53dd43296a5789a0dae9cb628c35c Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 15:21:11 +0200
Subject: [PATCH 39/45] Update examples.md

---
 docs/srvctl-racks-list/examples.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-racks-list/examples.md b/docs/srvctl-racks-list/examples.md
index 2834367..4b900df 100644
--- a/docs/srvctl-racks-list/examples.md
+++ b/docs/srvctl-racks-list/examples.md
@@ -7,7 +7,7 @@ srvctl racks list --all
 A command to filter private racks by location:
 
 ```
-srvctl racks list --location-id ex4mp1eID
+srvctl racks list --location-id 5
 ```
 
 A command to filter private racks by label:

From 54dbb514f4db926cffff746bf98c8c3ae9d5d71e Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 15:22:55 +0200
Subject: [PATCH 40/45] Update examples.md

---
 docs/srvctl-racks/examples.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/srvctl-racks/examples.md b/docs/srvctl-racks/examples.md
index 31c0d9b..3131528 100644
--- a/docs/srvctl-racks/examples.md
+++ b/docs/srvctl-racks/examples.md
@@ -2,8 +2,10 @@ A command to list all private racks for the account:
 
 ```
 srvctl racks list --all
+```
 
-srvctl racks get <rack-id>
+A command to get details of a specific rack:
 
-srvctl racks update <rack-id>
+```
+srvctl racks get <rack-id>
 ```

From 859c57beda7d999d0ce3f0c9f47718b260168238 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 15:37:08 +0200
Subject: [PATCH 41/45] Update description.md

---
 docs/srvctl-ssl-custom-add/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-ssl-custom-add/description.md b/docs/srvctl-ssl-custom-add/description.md
index 338e0cd..f5883ed 100644
--- a/docs/srvctl-ssl-custom-add/description.md
+++ b/docs/srvctl-ssl-custom-add/description.md
@@ -1,5 +1,5 @@
 A command to create a new custom SSL certificate. It allows to pass parameters in two ways:
 
-- Input - certificate parameters are described in a file, a path to the file is specified via the `-i` or `--input` flag. The path can be absolute or relative to the srvctl file. Parameters should be described as a request body of the Public API request. There is also an option to use standard input (stdin) when specifying the flag this way: `--input -`
+- Input - certificate parameters are described in a JSON file, a path to the file is specified via the `-i` or `--input` flag. The path can be absolute or relative to the srvctl file. Use the `--skeleton` flag to see the file's pattern. There is also an option to use standard input (stdin) when specifying the flag this way: `--input -`
 
 - Flags - parameters are specified via flags inside the command. The `--name`, `--public-key`, and `--private-key` flags are required. The `--chain-key` flag is optional.

From fe7bcf998df084fa76c7d9621f6dbbf003c2648a Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 15:44:23 +0200
Subject: [PATCH 42/45] Update description.md

---
 docs/srvctl-ssl-list/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-ssl-list/description.md b/docs/srvctl-ssl-list/description.md
index 0218a00..0c9856b 100644
--- a/docs/srvctl-ssl-list/description.md
+++ b/docs/srvctl-ssl-list/description.md
@@ -1 +1 @@
-This command lists all SSL certificates of the account regardless of type. Use `--help` to see available flags.
+This command lists all custom and Let's Encrypt SSL certificates of the account. Use `--help` to see available flags.

From acd65bc15bf433ffe058dc379a41ae2a08435b2d Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Wed, 25 Feb 2026 15:46:07 +0200
Subject: [PATCH 43/45] Update description.md

---
 docs/srvctl-ssl/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-ssl/description.md b/docs/srvctl-ssl/description.md
index 7b00c2a..3bc1c0a 100644
--- a/docs/srvctl-ssl/description.md
+++ b/docs/srvctl-ssl/description.md
@@ -1 +1 @@
-You can manage your SSL certificates by performing commands listed in `srvctl ssl --help`. Two certificate types are supported: custom certificates (`ssl custom`) and Let's Encrypt certificates (`ssl le`).
+You can manage your SSL certificates by performing commands listed in `srvctl ssl --help`. Two certificate types are supported: custom (`custom`) and Let's Encrypt (`le`).

From 1414377f19f3dd917ceaad2627ded041c182d842 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Thu, 26 Feb 2026 11:05:52 +0200
Subject: [PATCH 44/45] Update description.md

---
 docs/srvctl-cloud-instances-add/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-cloud-instances-add/description.md b/docs/srvctl-cloud-instances-add/description.md
index f98ea0b..3b4f86b 100644
--- a/docs/srvctl-cloud-instances-add/description.md
+++ b/docs/srvctl-cloud-instances-add/description.md
@@ -1 +1 @@
-A command to create a new cloud instance. Parameters should be passed via the `-i` or `--input` flag pointing to a JSON file or stdin (`--input -`) for standard input in terminal. Use the `--skeleton` flag to see an example of how to describe a JSON with parameters. This JSON structure repeats the request body of the [Create instance PAPI request](https://developers.servers.com/api-documentation/v1/#tag/Cloud-Instance/operation/CreateACloudInstance).
+A command to create a new cloud instance. Parameters should be passed via the `-i` or `--input` flag pointing to a JSON file or stdin (`--input -`) for standard input in terminal. Use the `--skeleton` flag to see an example of how to describe a JSON with parameters.

From 393a4f7b9ea2917f126c5685fda09433543b6d26 Mon Sep 17 00:00:00 2001
From: Kirill Eremin <68240227+qireal@users.noreply.github.com>
Date: Thu, 26 Feb 2026 11:10:11 +0200
Subject: [PATCH 45/45] Update description.md

---
 docs/srvctl-l2-segments-add/description.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/srvctl-l2-segments-add/description.md b/docs/srvctl-l2-segments-add/description.md
index 34ed6e3..1164f78 100644
--- a/docs/srvctl-l2-segments-add/description.md
+++ b/docs/srvctl-l2-segments-add/description.md
@@ -1,5 +1,5 @@
 A command to create a new L2 segment. It allows to pass parameters in two ways:
 
-- Input - segment parameters are described in a file, a path to the file is specified via the `-i` or `--input` flag. The path can be absolute or relative to the srvctl file. Parameters should be described as a request body of the [Public API request](https://developers.servers.com/api-documentation/v1/#tag/L2-Segment/operation/CreateAnL2Segment). There is also an option to use standard input (stdin) when specifying the flag this way: `--input -`
+- Input - segment parameters are described in a file, a path to the file is specified via the `-i` or `--input` flag. The path can be absolute or relative to the srvctl file. Use the `--skeleton` flag to see an example of how to describe a JSON with parameters. There is also an option to use standard input (stdin) when specifying the flag this way: `--input -`
 
 - Flags - parameters are specified via flags inside the command. The `--type` and `--member` flags are required. Members are specified in `id=<string>,mode=<native|trunk>` format and can be repeated for multiple members.