feat: relegate legacy granting guides to a Low-Level APIs section

Access Grants are now the recommended way to grant access. The legacy
granting recipes move to a new "Low-Level APIs" section at the very
bottom of the nav, with warning banners steering readers to Access
Grants:

- Move smart-locks/access-codes/** and access-systems/
  managing-credentials/** to low-level-apis/ with .gitbook.yaml
  redirects for every old URL
- New Low-Level APIs landing page documenting the remaining legitimate
  low-level uses (custom PIN values, backup/offline code pools,
  unmanaged-code migration, direct credential inspection)
- Warning banners on the moved guides: no longer recommended for
  granting access; deprecation expected in the medium term
- Pointer hints (not moved) on ACS quick starts and Managing ACS Users
- Scope guard: lock/unlock, encoders, user suspension, access groups,
  and other non-granting guides stay where they are

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: sybohy

.gitbook.yaml

@@ -16,8 +16,6 @@ redirects:
   core-concepts/workspaces/client-session-tokens: core-concepts/authentication/client-session-tokens/README.md
   core-concepts/workspaces/client-session-tokens/implementing-client-sessions-for-device-management-in-the-backend: core-concepts/authentication/client-session-tokens/implementing-client-sessions-for-device-management-in-the-backend.md
   products/access-systems/user-management: capability-guides/access-systems/user-management.md
-  capability-guides/access-systems/managing-credentials: capability-guides/access-systems/managing-credentials.md
-  capability-guides/access-systems/assigning-credentials-to-users: capability-guides/access-systems/managing-credentials/assigning-credentials-to-users.md
   products/access-systems/suspending-and-unsuspending-users: capability-guides/access-systems/user-management/suspending-and-unsuspending-users.md
   products/seam-bridge-in-development: capability-guides/seam-bridge.md
   core-concepts/connect-webviews: core-concepts/connect-webviews/README.md
@@ -33,3 +31,21 @@ redirects:
   capability-guides/access-grants/updating-an-access-grant: use-cases/granting-access/access-grants/updating-an-access-grant.md
   capability-guides/access-grants/revoking-an-access-method: use-cases/granting-access/access-grants/revoking-an-access-method.md
   capability-guides/access-grants/deleting-an-access-grant: use-cases/granting-access/access-grants/deleting-an-access-grant.md
+  capability-guides/smart-locks/access-codes: low-level-apis/access-codes/README.md
+  capability-guides/smart-locks/access-codes/creating-access-codes: low-level-apis/access-codes/creating-access-codes/README.md
+  capability-guides/smart-locks/access-codes/creating-access-codes/understanding-code-constraints: low-level-apis/access-codes/creating-access-codes/understanding-code-constraints.md
+  capability-guides/smart-locks/access-codes/retrieving-access-codes: low-level-apis/access-codes/retrieving-access-codes.md
+  capability-guides/smart-locks/access-codes/modifying-access-codes: low-level-apis/access-codes/modifying-access-codes.md
+  capability-guides/smart-locks/access-codes/deleting-access-codes: low-level-apis/access-codes/deleting-access-codes.md
+  capability-guides/smart-locks/access-codes/lifecycle-of-access-codes: low-level-apis/access-codes/lifecycle-of-access-codes.md
+  capability-guides/smart-locks/access-codes/access-code-requirements-for-door-locks: low-level-apis/access-codes/access-code-requirements-for-door-locks.md
+  capability-guides/smart-locks/access-codes/accommodating-manufacturer-mobile-apps: low-level-apis/access-codes/accommodating-manufacturer-mobile-apps.md
+  capability-guides/smart-locks/access-codes/troubleshooting-access-code-issues: low-level-apis/access-codes/troubleshooting-access-code-issues.md
+  capability-guides/smart-locks/access-codes/backup-access-codes: low-level-apis/access-codes/backup-access-codes.md
+  capability-guides/smart-locks/access-codes/offline-access-codes: low-level-apis/access-codes/offline-access-codes.md
+  capability-guides/smart-locks/access-codes/creating-and-updating-multiple-linked-access-codes: low-level-apis/access-codes/creating-and-updating-multiple-linked-access-codes.md
+  capability-guides/smart-locks/access-codes/migrating-existing-access-codes: low-level-apis/access-codes/migrating-existing-access-codes.md
+  capability-guides/access-systems/managing-credentials: low-level-apis/managing-credentials.md
+  capability-guides/access-systems/managing-credentials/assigning-credentials-to-users: low-level-apis/managing-credentials/assigning-credentials-to-users.md
+  capability-guides/access-systems/managing-credentials/listing-credentials-and-associated-entrances: low-level-apis/managing-credentials/listing-credentials-and-associated-entrances.md
+  capability-guides/access-systems/assigning-credentials-to-users: low-level-apis/managing-credentials/assigning-credentials-to-users.md

docs/guides/SUMMARY.md

@@ -61,20 +61,6 @@
 * [Smart Locks](capability-guides/smart-locks/README.md)
   * [Get started with Smart Locks](capability-guides/smart-locks/get-started-with-smartlocks-api.md)
   * [Locking and Unlocking Smart Locks](capability-guides/smart-locks/lock-and-unlock.md)
-  * [Creating and Managing Smart Lock Access Codes](capability-guides/smart-locks/access-codes/README.md)
-    * [Creating Access Codes](capability-guides/smart-locks/access-codes/creating-access-codes/README.md)
-      * [Understanding Code Constraints](capability-guides/smart-locks/access-codes/creating-access-codes/understanding-code-constraints.md)
-    * [Retrieving Access Codes](capability-guides/smart-locks/access-codes/retrieving-access-codes.md)
-    * [Modifying Access Codes](capability-guides/smart-locks/access-codes/modifying-access-codes.md)
-    * [Deleting Access Codes](capability-guides/smart-locks/access-codes/deleting-access-codes.md)
-    * [Lifecycle of Access Codes](capability-guides/smart-locks/access-codes/lifecycle-of-access-codes.md)
-    * [Access Code Requirements for Door Locks](capability-guides/smart-locks/access-codes/access-code-requirements-for-door-locks.md)
-    * [Streamlining Access Code Management from the Manufacturer App](capability-guides/smart-locks/access-codes/accommodating-manufacturer-mobile-apps.md)
-    * [Troubleshooting Access Codes](capability-guides/smart-locks/access-codes/troubleshooting-access-code-issues.md)
-    * [Managing Backup Access Codes](capability-guides/smart-locks/access-codes/backup-access-codes.md)
-    * [Managing Offline Access Codes](capability-guides/smart-locks/access-codes/offline-access-codes.md)
-    * [Creating and Updating Multiple Linked Access Codes](capability-guides/smart-locks/access-codes/creating-and-updating-multiple-linked-access-codes.md)
-    * [Migrating Existing Unmanaged Access Codes](capability-guides/smart-locks/access-codes/migrating-existing-access-codes.md)
 * [Access Control Systems](capability-guides/access-systems/README.md)
   * [Access System Quick Starts](capability-guides/access-systems/acs-quick-starts/README.md)
     * [PIN Code Quick Start](capability-guides/access-systems/acs-quick-starts/pin-code-quick-start.md)
@@ -88,9 +74,6 @@
     * [Suspending and Unsuspending ACS Users](capability-guides/access-systems/user-management/suspending-and-unsuspending-users.md)
     * [Assigning ACS Users to Access Groups](capability-guides/access-systems/user-management/assigning-users-to-access-groups.md)
   * [Retrieving Entrance Details](capability-guides/access-systems/retrieving-entrance-details.md)
-  * [Managing Credentials](capability-guides/access-systems/managing-credentials.md)
-    * [Assigning Credentials to ACS Users](capability-guides/access-systems/managing-credentials/assigning-credentials-to-users.md)
-    * [Listing Credentials and Associated Entrances](capability-guides/access-systems/managing-credentials/listing-credentials-and-associated-entrances.md)
   * [Working with Card Encoders and Scanners](capability-guides/access-systems/working-with-card-encoders-and-scanners/README.md)
     * [Creating and Encoding Card-based Credentials](capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials.md)
     * [Creating and Encoding Card Access Methods](capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-access-methods.md)
@@ -196,3 +179,24 @@
   * [Creating Intercom CRUD Endpoints](device-manufacturer-guidance/creating-a-seam-compatible-intercom-api/creating-intercom-crud-endpoints.md)
   * [Creating Access Code CRUD Endpoints](device-manufacturer-guidance/creating-a-seam-compatible-intercom-api/creating-access-code-crud-endpoints.md)
   * [Creating the Health Endpoint](device-manufacturer-guidance/creating-a-seam-compatible-intercom-api/creating-the-health-endpoint.md)
+
+## Low-Level APIs
+
+* [Low-Level APIs](low-level-apis/README.md)
+  * [Creating and Managing Smart Lock Access Codes](low-level-apis/access-codes/README.md)
+    * [Creating Access Codes](low-level-apis/access-codes/creating-access-codes/README.md)
+      * [Understanding Code Constraints](low-level-apis/access-codes/creating-access-codes/understanding-code-constraints.md)
+    * [Retrieving Access Codes](low-level-apis/access-codes/retrieving-access-codes.md)
+    * [Modifying Access Codes](low-level-apis/access-codes/modifying-access-codes.md)
+    * [Deleting Access Codes](low-level-apis/access-codes/deleting-access-codes.md)
+    * [Lifecycle of Access Codes](low-level-apis/access-codes/lifecycle-of-access-codes.md)
+    * [Access Code Requirements for Door Locks](low-level-apis/access-codes/access-code-requirements-for-door-locks.md)
+    * [Streamlining Access Code Management from the Manufacturer App](low-level-apis/access-codes/accommodating-manufacturer-mobile-apps.md)
+    * [Troubleshooting Access Codes](low-level-apis/access-codes/troubleshooting-access-code-issues.md)
+    * [Managing Backup Access Codes](low-level-apis/access-codes/backup-access-codes.md)
+    * [Managing Offline Access Codes](low-level-apis/access-codes/offline-access-codes.md)
+    * [Creating and Updating Multiple Linked Access Codes](low-level-apis/access-codes/creating-and-updating-multiple-linked-access-codes.md)
+    * [Migrating Existing Unmanaged Access Codes](low-level-apis/access-codes/migrating-existing-access-codes.md)
+  * [Managing ACS Credentials](low-level-apis/managing-credentials.md)
+    * [Assigning Credentials to ACS Users](low-level-apis/managing-credentials/assigning-credentials-to-users.md)
+    * [Listing Credentials and Associated Entrances](low-level-apis/managing-credentials/listing-credentials-and-associated-entrances.md)

docs/guides/capability-guides/access-systems/README.md

@@ -70,5 +70,5 @@ Find out more about using Seam to manage access control system resources. See th
 6. Learn about available entrances.
    * [Retrieving Entrance Details](../../capability-guides/access-systems/retrieving-entrance-details.md)
 7. Create credentials for ACS users.
-   * [Managing Credentials](../../capability-guides/access-systems/managing-credentials.md)
+   * [Managing Credentials](../../low-level-apis/managing-credentials.md)
 8. See the Seam [Access Control Systems API reference](https://docs.seam.co/latest/api/acs/).

docs/guides/capability-guides/access-systems/acs-quick-starts/README.md

@@ -7,6 +7,10 @@ description: >-
 
 # Access System Quick Starts
 
+{% hint style="success" %}
+**Granting access?** [Access Grants](../../../use-cases/granting-access/README.md) are the default and recommended way to issue PIN codes, key cards, and mobile keys across access systems and standalone smart locks. Start with the [Access Grant Quick Start](../../../use-cases/granting-access/access-grants/access-grant-quick-start.md).
+{% endhint %}
+
 * [PIN Code Quick Start](pin-code-quick-start.md)\
   Create your first PIN code credential to grant an access system user scheduled access to a virtual entrance that has a keypad.
 * [Encodable Key Card Quick Start](encodable-key-card-quick-start.md)\

docs/guides/capability-guides/access-systems/acs-quick-starts/encodable-key-card-quick-start.md

@@ -22,7 +22,7 @@ This quick start walks you through the following basic steps:
    * To get started quickly, use a virtual ACS in a [sandbox workspace](../../../core-concepts/workspaces/#sandbox-workspaces).
 2. Install a Seam SDK and create an API key.
 3. Create an [ACS user](../user-management.md).
-4.  Create an encodable key card [ACS credential](../managing-credentials.md) for the ACS user.
+4.  Create an encodable key card [ACS credential](../../../low-level-apis/managing-credentials.md) for the ACS user.
 
     This credential contains both the set of entrances to which the user has access and the access schedule for the user.\
     While some access control systems specify allowed entrances directly within the credential, others use access groups. For more details, see [Access Permission Assignment Variations](../connect-an-acs-to-seam/understanding-access-control-system-differences.md#access-permission-assignment-variations).
@@ -807,7 +807,7 @@ For a deeper dive into ACS concepts and instructions, see the following topics:
 4. Learn about available entrances.
    * [Retrieving Entrance Details](../retrieving-entrance-details.md)
 5. Create credentials for ACS users.
-   * [Managing Credentials](../managing-credentials.md)
+   * [Managing Credentials](../../../low-level-apis/managing-credentials.md)
 6. For relevant access control systems, encode credentials onto key cards.
    * [Working with Card Encoders and Scanners](../working-with-card-encoders-and-scanners/)
 7. See the Seam [Access Control Systems API reference](https://docs.seam.co/latest/api/acs/).

docs/guides/capability-guides/access-systems/acs-quick-starts/mobile-key-quick-start.md

@@ -24,7 +24,7 @@ This quick start walks you through the following basic steps:
 4. Assign the user identity to an [access group](../user-management/assigning-users-to-access-groups.md).
    * Access groups are preconfigured to grant access to specific entrances.\
      While some access control systems use access groups, others specify allowed entrances directly within the credential. For more details, see [Access Permission Assignment Variations](../connect-an-acs-to-seam/understanding-access-control-system-differences.md#access-permission-assignment-variations).
-5. Create a mobile key [ACS credential](../managing-credentials.md) for the user identity.
+5. Create a mobile key [ACS credential](../../../low-level-apis/managing-credentials.md) for the user identity.
 6. View the list of entrances to which the user now has access.
 
 :rocket: Let's get started!
@@ -613,7 +613,7 @@ For a deeper dive into ACS concepts and instructions, see the following topics:
 4. Learn about available entrances.
    * [Retrieving Entrance Details](../retrieving-entrance-details.md)
 5. Create credentials for ACS users.
-   * [Managing Credentials](../managing-credentials.md)
+   * [Managing Credentials](../../../low-level-apis/managing-credentials.md)
 6. Learn more about the Seam mobile access solution.
    * [Mobile Access](../../mobile-access/)
    * [Integrating into your mobile application](../../mobile-access/mobile-device-sdks/)

docs/guides/capability-guides/access-systems/acs-quick-starts/pin-code-quick-start.md

@@ -24,7 +24,7 @@ This quick start walks you through the following basic steps:
 4. Assign the ACS user to an [access group](../user-management/assigning-users-to-access-groups.md).
    * Access groups are preconfigured to grant access to specific entrances.\
      While some access control systems use access groups, others specify allowed entrances directly within the credential. For more details, see [Access Permission Assignment Variations](../connect-an-acs-to-seam/understanding-access-control-system-differences.md#access-permission-assignment-variations).
-5. Create a PIN code [ACS credential](../managing-credentials.md) for the ACS user.
+5. Create a PIN code [ACS credential](../../../low-level-apis/managing-credentials.md) for the ACS user.
 6. View the following information about your successfully-created credential:
    * The PIN code for the credential.
    * The access schedule for the ACS user.
@@ -650,5 +650,5 @@ For a deeper dive into ACS concepts and instructions, see the following topics:
 4. Learn about available entrances.
    * [Retrieving Entrance Details](../retrieving-entrance-details.md)
 5. Create credentials for ACS users.
-   * [Managing Credentials](../managing-credentials.md)
+   * [Managing Credentials](../../../low-level-apis/managing-credentials.md)
 6. See the Seam [Access Control Systems API reference](https://docs.seam.co/latest/api/acs/).