From ed0e178ee6466b18c0452a5432c7623331f749ed Mon Sep 17 00:00:00 2001
From: Vigneshraj Sekar Babu <vignesh.raj47@gmail.com>
Date: Mon, 12 Oct 2026 16:28:31 -0700
Subject: [PATCH] docs(sites): document renaming a site

---
 documentation-style-baseline.json | 10 +++++-----
 src/pages/docs/features/cli.mdx   |  3 ++-
 src/pages/docs/features/sites.mdx |  9 +++++++--
 3 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/documentation-style-baseline.json b/documentation-style-baseline.json
index ce352b0..9fa6abf 100644
--- a/documentation-style-baseline.json
+++ b/documentation-style-baseline.json
@@ -1,6 +1,6 @@
 {
   "schemaVersion": 3,
-  "updatedOn": "2026-10-09",
+  "updatedOn": "2026-10-12",
   "references": {
     "canonical": "ASD-STE100 Issue 9",
     "canonicalRules": [
@@ -135,8 +135,8 @@
     "/docs/features/cli": {
       "file": "src/pages/docs/features/cli.mdx",
       "profile": "asd-ste100",
-      "reviewedOn": "2026-10-09",
-      "sha256": "b874b693d8a1acd30209d3351b5a64d4799415e21d4e73844c812908aae1bd5d"
+      "reviewedOn": "2026-10-12",
+      "sha256": "5d5c2b5509c4423e79fb1725d96b5eb976b7ab2566b4463e69f735737ca752b4"
     },
     "/docs/features/cli-telemetry": {
       "file": "src/pages/docs/features/cli-telemetry.mdx",
@@ -201,8 +201,8 @@
     "/docs/features/sites": {
       "file": "src/pages/docs/features/sites.mdx",
       "profile": "asd-ste100",
-      "reviewedOn": "2026-10-09",
-      "sha256": "1b20228a0ac155a39926073b6d26128df720a59acb13c1463ca05cb000472ca8"
+      "reviewedOn": "2026-10-12",
+      "sha256": "5d0b69784c91e3931fd48c7d3fcf8559ae2339657e7cb95452f7d850d8218687"
     },
     "/docs/features/template-variables": {
       "file": "src/pages/docs/features/template-variables.mdx",
diff --git a/src/pages/docs/features/cli.mdx b/src/pages/docs/features/cli.mdx
index eded402..e833bcb 100644
--- a/src/pages/docs/features/cli.mdx
+++ b/src/pages/docs/features/cli.mdx
@@ -236,6 +236,7 @@ lfc sites create <file-or-dir> [--name <label>] [--visibility private|public] [-
 lfc sites list [--mine | --public | --deleted] [--search <text>]
 lfc sites get <id>
 lfc sites update <id> <file-or-dir>
+lfc sites rename <id> <name>
 lfc sites visibility <id> private|public [--yes]
 lfc sites extend <id>                             # extend expiration
 lfc sites delete <id> --yes
@@ -243,7 +244,7 @@ lfc sites restore <id>
 ```
 
 The CLI prints the site's `openUrl`.
-Changing visibility keeps the Site ID and content URL.
+Renaming or changing visibility keeps the Site ID and content URL.
 After `delete`, the CLI shows the time until which you can restore the site.
 `restore` keeps the Site ID and URL.
 If a change returns `409`, fetch the site again before you retry.
diff --git a/src/pages/docs/features/sites.mdx b/src/pages/docs/features/sites.mdx
index b3c8c06..249eb62 100644
--- a/src/pages/docs/features/sites.mdx
+++ b/src/pages/docs/features/sites.mdx
@@ -34,7 +34,7 @@ Administrator access does not give ownership rights.
 | Private (default) | Only the owner                          | Only the owner    |
 | Public            | Anyone with the URL, without signing in | Only the owner    |
 
-The owner can replace content, extend expiration, change visibility, delete the site, or restore a deleted site.
+The owner can replace content, rename the site, extend expiration, change visibility, delete the site, or restore a deleted site.
 Public content can contain copies that remain outside Lifecycle after you make the site private.
 Sites has no email invitations or viewer or editor roles.
 
@@ -55,7 +55,9 @@ Sites has no email invitations or viewer or editor roles.
 Search matches the site name or ID.
 Search and pagination do not expose other users' private sites.
 
-From an owned site's actions menu, you can replace content, change visibility, or delete it.
+From an owned site's actions menu, you can replace content, rename it, change visibility, or delete it.
+Renaming changes only the display name.
+The site ID and content URL stay the same.
 The visibility dialog requires confirmation before publication.
 When you change visibility, the site ID and content URL stay the same.
 New requests to a private site require owner access.
@@ -100,6 +102,7 @@ lfc sites list --mine
 lfc sites list --public --search report
 lfc sites get a1b2c3d4e5
 lfc sites update a1b2c3d4e5 ./dist
+lfc sites rename a1b2c3d4e5 "performance report"
 lfc sites visibility a1b2c3d4e5 private --yes
 lfc sites extend a1b2c3d4e5
 lfc sites delete a1b2c3d4e5 --yes
@@ -165,6 +168,7 @@ A scope permits an operation only when the caller also has the required ownershi
 | Delete a site     | `DELETE /api/v2/sites/{siteId}`       | `sites:write` |
 | Replace content   | `PUT /api/v2/sites/{siteId}/content`  | `sites:write` |
 | Extend expiration | `POST /api/v2/sites/{siteId}/extend`  | `sites:write` |
+| Rename a site     | `PATCH /api/v2/sites/{siteId}`        | `sites:write` |
 | Change visibility | `PATCH /api/v2/sites/{siteId}/access` | `sites:write` |
 | Restore a site    | `POST /api/v2/sites/{siteId}/restore` | `sites:write` |
 
@@ -191,6 +195,7 @@ curl --fail --silent --show-error \
   "${LIFECYCLE_URL}/api/v2/sites"
 ```
 
+Renaming requires the JSON field `name` (1-255 characters) and accepts an optional `expectedAccessRevision`.
 Visibility changes require JSON fields `visibility` and `expectedAccessRevision`.
 For replacement, send `expectedAccessRevision` and `expectedContentRevision` as multipart fields.
 Older replacement clients can also receive `409` after a concurrent change.