fix: brand guide card links and rewrite authentication overview

- Fix all card hrefs in Brand Guides to include /device-and-system-integration-guides/ prefix
- Rewrite Authentication page with CardGroup cards and comparison table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: dawnho

mintlify-docs/core-concepts/authentication/index.mdx

@@ -1,10 +1,30 @@
 ---
-title: 'Authentication'
-description: 'You can use any of several methods to authenticate with the Seam API.'
+title: "Authentication"
+description: "Choose the right authentication method for your Seam integration — API keys for server-side, client sessions for frontend apps, or personal access tokens for development."
 ---
 
-You can use any of the following methods to authenticate to the Seam API:
+Seam supports several authentication methods, each designed for a different use case. All methods authenticate against the Seam API at `https://connect.getseam.com`.
 
-- [Use an API key.](api-keys.md)
-- [Use a Personal Access Token.](personal-access-tokens.md)
-- [Use client sessions and client session tokens.](client-session-tokens/)
+<CardGroup cols={3}>
+  <Card title="API Keys" icon="key" href="/core-concepts/authentication/api-keys">
+    Server-side authentication for production apps. Create API keys in Seam Console and pass them via the `Authorization` header or SDK constructor.
+  </Card>
+  <Card title="Personal Access Tokens" icon="user" href="/core-concepts/authentication/personal-access-tokens">
+    Authenticate as yourself across all your workspaces. Ideal for development, scripting, and the Seam CLI.
+  </Card>
+  <Card title="Client Session Tokens" icon="browser" href="/core-concepts/authentication/client-session-tokens">
+    Scoped tokens for frontend apps. Grant users access to specific devices without exposing your API key.
+  </Card>
+</CardGroup>
+
+## Choosing the Right Method
+
+| Method | Use case | Scope | Where to use |
+|--------|----------|-------|--------------|
+| **API Key** | Production backend | Single workspace | Server-side only |
+| **Personal Access Token** | Development and CLI | All your workspaces | Local dev, scripts |
+| **Client Session Token** | Frontend apps | Scoped to specific devices | Browser, mobile |
+
+<Info>
+API keys and personal access tokens should never be exposed in client-side code. Use client session tokens for any frontend integration.
+</Info>

mintlify-docs/device-and-system-integration-guides/index.mdx

@@ -21,87 +21,87 @@ To find the integration guide for each of your devices or systems, see the follo
 <CardGroup cols={2}>
   <Card
     title='2N Intercom Systems'
-    href='/2n-intercom-systems/'
+    href='/device-and-system-integration-guides/2n-intercom-systems/'
     img='/images/2n-logo.png'
   ></Card>
   <Card
     title='33 Lock Devices'
-    href='/33-lock-devices/'
+    href='/device-and-system-integration-guides/33-lock-devices/'
     img='/images/33-lock-logo.png'
   ></Card>
   <Card
     title='4SUITES Locks'
-    href='/4suites-locks/'
+    href='/device-and-system-integration-guides/4suites-locks/'
     img='/images/4suites-logo.png'
   ></Card>
   <Card
     title='Akiles Locks'
-    href='/akiles-locks/'
+    href='/device-and-system-integration-guides/akiles-locks/'
     img='/images/akiles-logo.png'
   ></Card>
   <Card
     title='August Locks'
-    href='/august-locks/'
+    href='/device-and-system-integration-guides/august-locks/'
     img='/images/august-logo.png'
   ></Card>
   <Card
     title='dormakaba Oracode Locks'
-    href='/dormakaba-oracode-locks/'
+    href='/device-and-system-integration-guides/dormakaba-oracode-locks/'
     img='/images/dormakaba-logo.png'
   ></Card>
   <Card
     title='iglooHome Locks'
-    href='/igloohome-locks/'
+    href='/device-and-system-integration-guides/igloohome-locks/'
     img='/images/igloohome-logo.png'
   ></Card>
   <Card
     title='Kwikset Locks'
-    href='/kwikset-locks/'
+    href='/device-and-system-integration-guides/kwikset-locks/'
     img='/images/kwikset-logo.png'
   ></Card>
   <Card
     title='Lockly Locks'
-    href='/lockly-locks/'
+    href='/device-and-system-integration-guides/lockly-locks/'
     img='/images/lockly-logo.png'
   ></Card>
   <Card
     title='Nuki Locks'
-    href='/nuki-locks/'
+    href='/device-and-system-integration-guides/nuki-locks/'
     img='/images/nuki-logo.png'
   ></Card>
   <Card
     title='Salto KS Locks'
-    href='/salto-locks/'
+    href='/device-and-system-integration-guides/salto-locks/'
     img='/images/salto-logo.png'
   ></Card>
   <Card
     title='Schlage Locks'
-    href='/schlage-locks/'
+    href='/device-and-system-integration-guides/schlage-locks/'
     img='/images/schlage-logo.png'
   ></Card>
   <Card
     title='SmartThings Hubs + Smart Locks'
-    href='/smartthings-hubs-+-devices/'
+    href='/device-and-system-integration-guides/smartthings-hubs-+-devices/'
     img='/images/smartthings-logo.png'
   ></Card>
   <Card
     title='Tedee Locks'
-    href='/tedee-locks/'
+    href='/device-and-system-integration-guides/tedee-locks/'
     img='/images/tedee-logo.png'
   ></Card>
   <Card
     title='TTLock Locks'
-    href='/ttlock-locks/'
+    href='/device-and-system-integration-guides/ttlock-locks/'
     img='/images/ttlock-logo.png'
   ></Card>
   <Card
     title='Wyze Locks'
-    href='/wyze-locks/'
+    href='/device-and-system-integration-guides/wyze-locks/'
     img='/images/wyze-logo.png'
   ></Card>
   <Card
     title='Yale Locks'
-    href='/yale-locks/'
+    href='/device-and-system-integration-guides/yale-locks/'
     img='/images/yale-logo.png'
   ></Card>
 </CardGroup>
@@ -113,42 +113,42 @@ To find the integration guide for each of your devices or systems, see the follo
 <CardGroup cols={2}>
   <Card
     title='ASSA ABLOY Credential Services'
-    href='/assa-abloy-vingcard-credential-services/'
+    href='/device-and-system-integration-guides/assa-abloy-vingcard-credential-services/'
     img='/images/assa-abloy-logo.png'
   ></Card>
   <Card
     title='ASSA ABLOY Visionline Access Control System'
-    href='/assa-abloy-visionline-access-control-system/'
+    href='/device-and-system-integration-guides/assa-abloy-visionline-access-control-system/'
     img='/images/assa-abloy-logo.png'
   ></Card>
   <Card
     title='Avigilon Alta Access System'
-    href='/avigilon-alta-access-system/'
+    href='/device-and-system-integration-guides/avigilon-alta-access-system/'
     img='/images/avigilon-alta-logo.png'
   ></Card>
   <Card
     title='Brivo Access'
-    href='/brivo-access/'
+    href='/device-and-system-integration-guides/brivo-access/'
     img='/images/brivo-logo.png'
   ></Card>
   <Card
     title='Latch Access Control System'
-    href='/latch-access-control-system/'
+    href='/device-and-system-integration-guides/latch-access-control-system/'
     img='/images/latch-logo.png'
   ></Card>
   <Card
     title='PTI Storlogix Cloud'
-    href='/pti-storlogix-cloud/'
+    href='/device-and-system-integration-guides/pti-storlogix-cloud/'
     img='/images/pti-logo.png'
   ></Card>
   <Card
     title='Salto KS Access Control System'
-    href='/salto-ks-access-control-system/'
+    href='/device-and-system-integration-guides/salto-ks-access-control-system/'
     img='/images/salto-ks-logo.png'
   ></Card>
   <Card
     title='Salto ProAccess Space Access System'
-    href='/salto-proaccess-space-access-system/'
+    href='/device-and-system-integration-guides/salto-proaccess-space-access-system/'
     img='/images/salto-space-logo.png'
   ></Card>
 </CardGroup>
@@ -160,27 +160,27 @@ To find the integration guide for each of your devices or systems, see the follo
 <CardGroup cols={2}>
   <Card
     title='ecobee Thermostats'
-    href='/ecobee-thermostats/'
+    href='/device-and-system-integration-guides/ecobee-thermostats/'
     img='/images/ecobee-logo.png'
   ></Card>
   <Card
     title='Google Nest Thermostats'
-    href='/google-nest-thermostats/'
+    href='/device-and-system-integration-guides/google-nest-thermostats/'
     img='/images/nest-logo.png'
   ></Card>
   <Card
     title='Honeywell Resideo Thermostats'
-    href='/honeywell-thermostats/'
+    href='/device-and-system-integration-guides/honeywell-thermostats/'
     img='/images/honeywell-logo.png'
   ></Card>
   <Card
     title='Sensi Thermostats'
-    href='/sensi-thermostats/'
+    href='/device-and-system-integration-guides/sensi-thermostats/'
     img='/images/sensi-logo.png'
   ></Card>
   <Card
     title='SmartThings Hubs + Thermostats'
-    href='/smartthings-hubs-+-devices/'
+    href='/device-and-system-integration-guides/smartthings-hubs-+-devices/'
     img='/images/smartthings-logo.png'
   ></Card>
 </CardGroup>
@@ -192,12 +192,12 @@ To find the integration guide for each of your devices or systems, see the follo
 <CardGroup cols={2}>
   <Card
     title='Minut Sensors'
-    href='/minut-sensors/'
+    href='/device-and-system-integration-guides/minut-sensors/'
     img='/images/minut-logo.png'
   ></Card>
   <Card
     title='NoiseAware Sensors'
-    href='/noiseaware-sensors/'
+    href='/device-and-system-integration-guides/noiseaware-sensors/'
     img='/images/noiseaware-logo.png'
   ></Card>
 </CardGroup>
@@ -209,7 +209,7 @@ To find the integration guide for each of your devices or systems, see the follo
 <CardGroup cols={2}>
   <Card
     title='ControlByWeb Relays'
-    href='/controlbyweb-relays/'
+    href='/device-and-system-integration-guides/controlbyweb-relays/'
     img='/images/controlbyweb-logo.png'
   ></Card>
 </CardGroup>