Fix broken cross-site links: move files to match published URLs (#1071)

* Fix broken URLs in codegen/data/paths.yaml

- Fix lock description linking to thermostats instead of smart-locks
- Remove .md extension from API URL

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

* Move files to match published URL paths

Move products/ files into capability-guides/ and webhooks from
core-concepts/ to developer-tools/ so file paths match the URLs
that GitBook publishes. Update all relative links and SUMMARY.md.

Eliminates the products/ directory entirely.

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

* Fix broken links in hand-written guide pages

- Fix escaped underscores in thermostat set_temperature_threshold URLs
- Fix mobile/ios/quickstart → developer-tools/mobile-sdks/ios-sdk

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

* ci: Generate docs

* Revert escaped underscore changes in thermostat URLs

The \_  escaping is intentional GitBook markdown to prevent italic
rendering. The validator should handle this, not the content.

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

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Seam Bot <seambot@getseam.com>

Author: 3 people

codegen/data/paths.yaml

@@ -75,7 +75,7 @@
 
     Represents a [noise sensor](https://docs.seam.co/latest/capability-guides/noise-sensors).
 
-    Noise sensors are devices that measure that sound level in a given area. You can use noise sensors to monitor noise levels remotely and receive notifications when the noise volume is too loud. The Seam API enables you to configure the [noise thresholds](https://docs.seam.co/latest/capability-guides/noise-sensors/configure-noise-threshold-settings) of a noise sensor and receive events when a disturbance is detected. You can also [simulate triggering a noise threshold](https://docs.seam.co/latest/api/noise_sensors/simulate/trigger_noise_threshold.md).
+    Noise sensors are devices that measure that sound level in a given area. You can use noise sensors to monitor noise levels remotely and receive notifications when the noise volume is too loud. The Seam API enables you to configure the [noise thresholds](https://docs.seam.co/latest/capability-guides/noise-sensors/configure-noise-threshold-settings) of a noise sensor and receive events when a disturbance is detected. You can also [simulate triggering a noise threshold](https://docs.seam.co/latest/api/noise_sensors/simulate/trigger_noise_threshold).
 
     The Seam API represents a noise sensor as a `device` resource that includes both basic device properties and noise sensor-specific properties.
 
@@ -148,7 +148,7 @@
     - [Events](./#events)
     - [Endpoints](./#endpoints)
 
-    Represents a [lock](https://docs.seam.co/latest/capability-guides/thermostats).
+    Represents a [lock](https://docs.seam.co/latest/capability-guides/smart-locks).
 
     The Seam API enables you to control connected smart locks from a wide variety of manufacturers, including locks that provide online and offline [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) programming.
 

docs/api-reference/locks/README.md

@@ -9,7 +9,7 @@
 - [Events](./#events)
 - [Endpoints](./#endpoints)
 
-Represents a [lock](https://docs.seam.co/latest/capability-guides/thermostats).
+Represents a [lock](https://docs.seam.co/latest/capability-guides/smart-locks).
 
 The Seam API enables you to control connected smart locks from a wide variety of manufacturers, including locks that provide online and offline [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) programming.
 

docs/api-reference/noise_sensors/README.md

@@ -7,7 +7,7 @@
 
 Represents a [noise sensor](https://docs.seam.co/latest/capability-guides/noise-sensors).
 
-Noise sensors are devices that measure that sound level in a given area. You can use noise sensors to monitor noise levels remotely and receive notifications when the noise volume is too loud. The Seam API enables you to configure the [noise thresholds](https://docs.seam.co/latest/capability-guides/noise-sensors/configure-noise-threshold-settings) of a noise sensor and receive events when a disturbance is detected. You can also [simulate triggering a noise threshold](https://docs.seam.co/latest/api/noise_sensors/simulate/trigger_noise_threshold.md).
+Noise sensors are devices that measure that sound level in a given area. You can use noise sensors to monitor noise levels remotely and receive notifications when the noise volume is too loud. The Seam API enables you to configure the [noise thresholds](https://docs.seam.co/latest/capability-guides/noise-sensors/configure-noise-threshold-settings) of a noise sensor and receive events when a disturbance is detected. You can also [simulate triggering a noise threshold](https://docs.seam.co/latest/api/noise_sensors/simulate/trigger_noise_threshold).
 
 The Seam API represents a noise sensor as a `device` resource that includes both basic device properties and noise sensor-specific properties.
 

docs/guides/README.md

@@ -34,7 +34,7 @@ With the Seam API, you can grant users access to entrances controlled by a varie
 
 Explore our device API guides to start connecting and controlling specific device and system categories.
 
-<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden><select></select></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Door Locks API</strong></td><td>Get started →</td><td><a href=".gitbook/assets/smart-locks-16-9.png">smart-locks-16-9.png</a></td><td></td><td><a href="products/smart-locks/">smart-locks</a></td></tr><tr><td><strong>Thermostats API</strong></td><td>Get started →</td><td><a href=".gitbook/assets/thermostats-cover.png">thermostats-cover.png</a></td><td></td><td><a href="products/thermostats/">thermostats</a></td></tr><tr><td><strong>Noise</strong> <strong>Sensors API</strong></td><td>Get started →</td><td><a href=".gitbook/assets/sensors-16-9.png">sensors-16-9.png</a></td><td></td><td><a href="products/noise-sensors/">noise-sensors</a></td></tr><tr><td><strong>Access Control Systems API</strong></td><td>Get started →</td><td><a href=".gitbook/assets/acs-cover.png">acs-cover.png</a></td><td></td><td><a href="products/access-systems/">access-systems</a></td></tr></tbody></table>
+<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden><select></select></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Door Locks API</strong></td><td>Get started →</td><td><a href=".gitbook/assets/smart-locks-16-9.png">smart-locks-16-9.png</a></td><td></td><td><a href="capability-guides/smart-locks/">smart-locks</a></td></tr><tr><td><strong>Thermostats API</strong></td><td>Get started →</td><td><a href=".gitbook/assets/thermostats-cover.png">thermostats-cover.png</a></td><td></td><td><a href="capability-guides/thermostats/">thermostats</a></td></tr><tr><td><strong>Noise</strong> <strong>Sensors API</strong></td><td>Get started →</td><td><a href=".gitbook/assets/sensors-16-9.png">sensors-16-9.png</a></td><td></td><td><a href="capability-guides/noise-sensors/">noise-sensors</a></td></tr><tr><td><strong>Access Control Systems API</strong></td><td>Get started →</td><td><a href=".gitbook/assets/acs-cover.png">acs-cover.png</a></td><td></td><td><a href="capability-guides/access-systems/">access-systems</a></td></tr></tbody></table>
 
 ***
 

docs/guides/SUMMARY.md

@@ -43,23 +43,23 @@
 ## Capability Guides
 
 * [Device and System Capabilities](capability-guides/device-and-system-capabilities.md)
-* [Smart Locks](products/smart-locks/README.md)
-  * [Locking and Unlocking Smart Locks](products/smart-locks/lock-and-unlock.md)
-  * [Creating and Managing Smart Lock Access Codes](products/smart-locks/access-codes/README.md)
+* [Smart Locks](capability-guides/smart-locks/README.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](products/smart-locks/access-codes/retrieving-access-codes.md)
-    * [Modifying Access Codes](products/smart-locks/access-codes/modifying-access-codes.md)
-    * [Deleting Access Codes](products/smart-locks/access-codes/deleting-access-codes.md)
-    * [Lifecycle of Access Codes](products/smart-locks/access-codes/lifecycle-of-access-codes.md)
-    * [Access Code Requirements for Door Locks](products/smart-locks/access-codes/access-code-requirements-for-door-locks.md)
-    * [Streamlining Access Code Management from the Manufacturer App](products/smart-locks/access-codes/accommodating-manufacturer-mobile-apps.md)
-    * [Troubleshooting Access Codes](products/smart-locks/access-codes/troubleshooting-access-code-issues.md)
-    * [Managing Backup Access Codes](products/smart-locks/access-codes/backup-access-codes.md)
-    * [Managing Offline Access Codes](products/smart-locks/access-codes/offline-access-codes.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](products/smart-locks/access-codes/migrating-existing-access-codes.md)
-* [Access Control Systems](products/access-systems/README.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)
     * [Encodable Key Card Quick Start](capability-guides/access-systems/acs-quick-starts/encodable-key-card-quick-start.md)
@@ -68,8 +68,8 @@
     * [Retrieving ACS System Details](capability-guides/access-systems/connect-an-acs-to-seam/retrieving-acs-system-details.md)
     * [Access Control System Resources](capability-guides/access-systems/connect-an-acs-to-seam/access-control-system-resources.md)
     * [Understanding Access Control System Differences](capability-guides/access-systems/connect-an-acs-to-seam/understanding-access-control-system-differences.md)
-  * [Managing ACS Users](products/access-systems/user-management.md)
-    * [Suspending and Unsuspending ACS Users](products/access-systems/suspending-and-unsuspending-users.md)
+  * [Managing ACS Users](capability-guides/access-systems/user-management.md)
+    * [Suspending and Unsuspending ACS Users](capability-guides/access-systems/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)
@@ -106,21 +106,21 @@
   * [Using Access Grants to Issue Instant Keys](capability-guides/instant-keys/using-access-grants-to-issue-instant-keys.md)
   * [Using Seam Console to Issue Instant Keys](capability-guides/instant-keys/using-seam-console-to-issue-instant-keys.md)
   * [Delivering Instant Keys](capability-guides/instant-keys/delivering-instant-keys.md)
-* [Thermostats](products/thermostats/README.md)
+* [Thermostats](capability-guides/thermostats/README.md)
   * [Understanding Thermostat Concepts](capability-guides/thermostats/understanding-thermostat-concepts/README.md)
     * [HVAC Mode](capability-guides/thermostats/understanding-thermostat-concepts/hvac-mode.md)
     * [Set Points](capability-guides/thermostats/understanding-thermostat-concepts/set-points.md)
-  * [Retrieving Thermostats](products/thermostats/retrieving-thermostats.md)
+  * [Retrieving Thermostats](capability-guides/thermostats/retrieving-thermostats.md)
   * [Setting and Monitoring Temperature Thresholds](capability-guides/thermostats/setting-and-monitoring-temperature-thresholds.md)
-  * [Setting the Current HVAC and Fan Mode Settings](products/thermostats/configure-current-climate-settings.md)
+  * [Setting the Current HVAC and Fan Mode Settings](capability-guides/thermostats/configure-current-climate-settings.md)
   * [Creating and Managing Climate Presets](capability-guides/thermostats/creating-and-managing-climate-presets/README.md)
     * [Setting the Fallback Climate Preset](capability-guides/thermostats/creating-and-managing-climate-presets/setting-the-fallback-climate-preset.md)
     * [Activating a Climate Preset](capability-guides/thermostats/creating-and-managing-climate-presets/activating-a-climate-preset.md)
   * [Creating and Managing Thermostat Schedules](capability-guides/thermostats/creating-and-managing-thermostat-schedules.md)
   * [Creating and Managing Thermostat Programs](capability-guides/thermostats/creating-and-managing-thermostat-programs.md)
   * [Testing Your Thermostat App with Simulate Endpoints](capability-guides/thermostats/testing-your-thermostat-app-with-simulate-endpoints.md)
-* [Noise Sensors](products/noise-sensors/README.md)
-  * [Configuring Noise Threshold Settings](products/noise-sensors/configure-noise-threshold-settings.md)
+* [Noise Sensors](capability-guides/noise-sensors/README.md)
+  * [Configuring Noise Threshold Settings](capability-guides/noise-sensors/configure-noise-threshold-settings.md)
 * [Seam Bridge](capability-guides/seam-bridge.md)
   * [Seam Bridge Setup for Windows](capability-guides/seam-bridge/seam-bridge-setup-for-windows.md)
   * [Seam Bridge Setup for macOS](capability-guides/seam-bridge/seam-bridge-setup-for-macos.md)
@@ -163,7 +163,7 @@
 
 ## Developer Tools
 
-* [Webhooks](core-concepts/webhooks.md)
+* [Webhooks](developer-tools/webhooks.md)
 * [Seam CLI](developer-tools/seam-cli.md)
 * [Seam MCP Server](developer-tools/seam-mcp.md)
 * [Sandbox Devices and Systems](device-guides/sandbox-and-sample-data/README.md)

…guides/products/access-systems/README.md …pability-guides/access-systems/README.mddocs/guides/products/access-systems/README.md renamed to docs/guides/capability-guides/access-systems/README.md docs/guides/products/access-systems/README.md renamed to docs/guides/capability-guides/access-systems/README.md

@@ -21,7 +21,7 @@ This quick start walks you through the following basic steps:
 1. [Connect](../../../core-concepts/workspaces/#connecting-virtual-devices) an access control system to Seam.
    * 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](../../../products/access-systems/user-management.md).
+3. Create an [ACS user](../../../capability-guides/access-systems/user-management.md).
 4.  Create an encodable key card [ACS credential](../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.\
@@ -801,7 +801,7 @@ For a deeper dive into ACS concepts and instructions, see the following topics:
    * [Access Control System Resources](../connect-an-acs-to-seam/access-control-system-resources.md)
    * [Understanding ACS Differences](../connect-an-acs-to-seam/understanding-access-control-system-differences.md)
 2. Create ACS users.
-   * [Managing ACS Users](../../../products/access-systems/user-management.md)
+   * [Managing ACS Users](../../../capability-guides/access-systems/user-management.md)
 3. For relevant access control systems, assign ACS users to access groups.
    * [Assigning ACS Users to Access Groups](../user-management/assigning-users-to-access-groups.md)
 4. Learn about available entrances.

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

@@ -19,7 +19,7 @@ This quick start walks you through the following basic steps:
 1. [Connect](../../../core-concepts/workspaces/#connecting-virtual-devices) an access control system to Seam.
    * 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](../../../products/access-systems/user-management.md).
+3. Create an [ACS user](../../../capability-guides/access-systems/user-management.md).
    * Also, specify the access schedule for this user.
 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.\
@@ -656,7 +656,7 @@ For a deeper dive into ACS concepts and instructions, see the following topics:
    * [Access Control System Resources](../connect-an-acs-to-seam/access-control-system-resources.md)
    * [Understanding ACS Differences](../connect-an-acs-to-seam/understanding-access-control-system-differences.md)
 2. Create ACS users.
-   * [Managing ACS Users](../../../products/access-systems/user-management.md)
+   * [Managing ACS Users](../../../capability-guides/access-systems/user-management.md)
 3. For relevant access control systems, assign ACS users to access groups.
    * [Assigning ACS Users to Access Groups](../user-management/assigning-users-to-access-groups.md)
 4. Learn about available entrances.

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

@@ -6,7 +6,7 @@ description: >-
 
 # Assigning Credentials to ACS Users
 
-This guide explains how to assign existing [credentials](managing-credentials.md) to [ACS users](../../products/access-systems/user-management.md) and unassign credentials from users. Once you assign credentials to ACS users, these users can use the credentials to access areas and resources according to their permissions. When you unassign credentials from ACS users, these users can no longer use these specific credentials to access areas or resources.
+This guide explains how to assign existing [credentials](managing-credentials.md) to [ACS users](../../capability-guides/access-systems/user-management.md) and unassign credentials from users. Once you assign credentials to ACS users, these users can use the credentials to access areas and resources according to their permissions. When you unassign credentials from ACS users, these users can no longer use these specific credentials to access areas or resources.
 
 ***