Skip to content

Commit 8e66e21

Browse files
sybohyclaude
andauthored
feat: relocate Smart Locks and ACS to Low-Level APIs in Mintlify (#1121)
Ports the #1115 structural change into the Mintlify docs (now the source of truth), on top of Dawn's #1119 polish — done by hand rather than re-running the migration script so her edits are preserved. - Move smart-locks and access-systems MDX trees under low-level-apis/ - docs.json Guides tab: new bottom "Low-Level APIs" group with nested Smart Locks / Access Control Systems sub-groups (matches the Low-Level APIs group Dawn already added to the API Reference tab) - Warning banners on both section indexes: low-level API, use Access Grants for granting, talk to the Seam team before building on them - Pointer hints on the granting sub-pages (access codes, managing credentials, ACS quick starts, ACS user management) - Remove the stale 'Access Grants in Alpha' notice from the card-encoding guide (#1117) - Rewrite ~166 internal links to the new paths; add docs.json redirects for the two moved subtrees Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 3a72934 commit 8e66e21

206 files changed

Lines changed: 828 additions & 753 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

mintlify-docs/SUMMARY.mdx

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -59,44 +59,44 @@ title: 'Table of contents'
5959
## Capability Guides
6060

6161
- [Device and System Capabilities](capability-guides/device-and-system-capabilities)
62-
- [Smart Locks](capability-guides/smart-locks/index)
63-
- [Get started with Smart Locks](capability-guides/smart-locks/get-started-with-smartlocks-api)
64-
- [Locking and Unlocking Smart Locks](capability-guides/smart-locks/lock-and-unlock)
65-
- [Creating and Managing Smart Lock Access Codes](capability-guides/smart-locks/access-codes/index)
66-
- [Creating Access Codes](capability-guides/smart-locks/access-codes/creating-access-codes/index)
67-
- [Understanding Code Constraints](capability-guides/smart-locks/access-codes/creating-access-codes/understanding-code-constraints)
68-
- [Retrieving Access Codes](capability-guides/smart-locks/access-codes/retrieving-access-codes)
69-
- [Modifying Access Codes](capability-guides/smart-locks/access-codes/modifying-access-codes)
70-
- [Deleting Access Codes](capability-guides/smart-locks/access-codes/deleting-access-codes)
71-
- [Lifecycle of Access Codes](capability-guides/smart-locks/access-codes/lifecycle-of-access-codes)
72-
- [Access Code Requirements for Door Locks](capability-guides/smart-locks/access-codes/access-code-requirements-for-door-locks)
73-
- [Streamlining Access Code Management from the Manufacturer App](capability-guides/smart-locks/access-codes/accommodating-manufacturer-mobile-apps)
74-
- [Troubleshooting Access Codes](capability-guides/smart-locks/access-codes/troubleshooting-access-code-issues)
75-
- [Managing Backup Access Codes](capability-guides/smart-locks/access-codes/backup-access-codes)
76-
- [Managing Offline Access Codes](capability-guides/smart-locks/access-codes/offline-access-codes)
77-
- [Creating and Updating Multiple Linked Access Codes](capability-guides/smart-locks/access-codes/creating-and-updating-multiple-linked-access-codes)
78-
- [Migrating Existing Unmanaged Access Codes](capability-guides/smart-locks/access-codes/migrating-existing-access-codes)
79-
- [Access Control Systems](capability-guides/access-systems/index)
80-
- [Access System Quick Starts](capability-guides/access-systems/acs-quick-starts/index)
81-
- [PIN Code Quick Start](capability-guides/access-systems/acs-quick-starts/pin-code-quick-start)
82-
- [Encodable Key Card Quick Start](capability-guides/access-systems/acs-quick-starts/encodable-key-card-quick-start)
83-
- [Mobile Key Quick Start](capability-guides/access-systems/acs-quick-starts/mobile-key-quick-start)
84-
- [Connect an Access System to Seam](capability-guides/access-systems/connect-an-acs-to-seam/index)
85-
- [Retrieving ACS System Details](capability-guides/access-systems/connect-an-acs-to-seam/retrieving-acs-system-details)
86-
- [Access Control System Resources](capability-guides/access-systems/connect-an-acs-to-seam/access-control-system-resources)
87-
- [Understanding Access Control System Differences](capability-guides/access-systems/connect-an-acs-to-seam/understanding-access-control-system-differences)
88-
- [Managing ACS Users](capability-guides/access-systems/user-management)
89-
- [Suspending and Unsuspending ACS Users](capability-guides/access-systems/user-management/suspending-and-unsuspending-users)
90-
- [Assigning ACS Users to Access Groups](capability-guides/access-systems/user-management/assigning-users-to-access-groups)
91-
- [Retrieving Entrance Details](capability-guides/access-systems/retrieving-entrance-details)
92-
- [Managing Credentials](capability-guides/access-systems/managing-credentials)
93-
- [Assigning Credentials to ACS Users](capability-guides/access-systems/managing-credentials/assigning-credentials-to-users)
94-
- [Listing Credentials and Associated Entrances](capability-guides/access-systems/managing-credentials/listing-credentials-and-associated-entrances)
95-
- [Working with Card Encoders and Scanners](capability-guides/access-systems/working-with-card-encoders-and-scanners/index)
96-
- [Creating and Encoding Card-based Credentials](capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials)
97-
- [Creating and Encoding Card Access Methods](capability-guides/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-access-methods)
98-
- [Scanning Encoded Cards](capability-guides/access-systems/working-with-card-encoders-and-scanners/scanning-encoded-cards)
99-
- [Troubleshooting Your Access Control System](capability-guides/access-systems/troubleshooting-your-access-control-system)
62+
- [Smart Locks](low-level-apis/smart-locks/index)
63+
- [Get started with Smart Locks](low-level-apis/smart-locks/get-started-with-smartlocks-api)
64+
- [Locking and Unlocking Smart Locks](low-level-apis/smart-locks/lock-and-unlock)
65+
- [Creating and Managing Smart Lock Access Codes](low-level-apis/smart-locks/access-codes/index)
66+
- [Creating Access Codes](low-level-apis/smart-locks/access-codes/creating-access-codes/index)
67+
- [Understanding Code Constraints](low-level-apis/smart-locks/access-codes/creating-access-codes/understanding-code-constraints)
68+
- [Retrieving Access Codes](low-level-apis/smart-locks/access-codes/retrieving-access-codes)
69+
- [Modifying Access Codes](low-level-apis/smart-locks/access-codes/modifying-access-codes)
70+
- [Deleting Access Codes](low-level-apis/smart-locks/access-codes/deleting-access-codes)
71+
- [Lifecycle of Access Codes](low-level-apis/smart-locks/access-codes/lifecycle-of-access-codes)
72+
- [Access Code Requirements for Door Locks](low-level-apis/smart-locks/access-codes/access-code-requirements-for-door-locks)
73+
- [Streamlining Access Code Management from the Manufacturer App](low-level-apis/smart-locks/access-codes/accommodating-manufacturer-mobile-apps)
74+
- [Troubleshooting Access Codes](low-level-apis/smart-locks/access-codes/troubleshooting-access-code-issues)
75+
- [Managing Backup Access Codes](low-level-apis/smart-locks/access-codes/backup-access-codes)
76+
- [Managing Offline Access Codes](low-level-apis/smart-locks/access-codes/offline-access-codes)
77+
- [Creating and Updating Multiple Linked Access Codes](low-level-apis/smart-locks/access-codes/creating-and-updating-multiple-linked-access-codes)
78+
- [Migrating Existing Unmanaged Access Codes](low-level-apis/smart-locks/access-codes/migrating-existing-access-codes)
79+
- [Access Control Systems](low-level-apis/access-systems/index)
80+
- [Access System Quick Starts](low-level-apis/access-systems/acs-quick-starts/index)
81+
- [PIN Code Quick Start](low-level-apis/access-systems/acs-quick-starts/pin-code-quick-start)
82+
- [Encodable Key Card Quick Start](low-level-apis/access-systems/acs-quick-starts/encodable-key-card-quick-start)
83+
- [Mobile Key Quick Start](low-level-apis/access-systems/acs-quick-starts/mobile-key-quick-start)
84+
- [Connect an Access System to Seam](low-level-apis/access-systems/connect-an-acs-to-seam/index)
85+
- [Retrieving ACS System Details](low-level-apis/access-systems/connect-an-acs-to-seam/retrieving-acs-system-details)
86+
- [Access Control System Resources](low-level-apis/access-systems/connect-an-acs-to-seam/access-control-system-resources)
87+
- [Understanding Access Control System Differences](low-level-apis/access-systems/connect-an-acs-to-seam/understanding-access-control-system-differences)
88+
- [Managing ACS Users](low-level-apis/access-systems/user-management)
89+
- [Suspending and Unsuspending ACS Users](low-level-apis/access-systems/user-management/suspending-and-unsuspending-users)
90+
- [Assigning ACS Users to Access Groups](low-level-apis/access-systems/user-management/assigning-users-to-access-groups)
91+
- [Retrieving Entrance Details](low-level-apis/access-systems/retrieving-entrance-details)
92+
- [Managing Credentials](low-level-apis/access-systems/managing-credentials)
93+
- [Assigning Credentials to ACS Users](low-level-apis/access-systems/managing-credentials/assigning-credentials-to-users)
94+
- [Listing Credentials and Associated Entrances](low-level-apis/access-systems/managing-credentials/listing-credentials-and-associated-entrances)
95+
- [Working with Card Encoders and Scanners](low-level-apis/access-systems/working-with-card-encoders-and-scanners/index)
96+
- [Creating and Encoding Card-based Credentials](low-level-apis/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-based-credentials)
97+
- [Creating and Encoding Card Access Methods](low-level-apis/access-systems/working-with-card-encoders-and-scanners/creating-and-encoding-card-access-methods)
98+
- [Scanning Encoded Cards](low-level-apis/access-systems/working-with-card-encoders-and-scanners/scanning-encoded-cards)
99+
- [Troubleshooting Your Access Control System](low-level-apis/access-systems/troubleshooting-your-access-control-system)
100100
- [Mobile Access](capability-guides/mobile-access/index)
101101
- [Prepare your Workspace](capability-guides/mobile-access/mobile-access-setup)
102102
- [Managing Mobile App User Accounts with User Identities](capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities)

mintlify-docs/api/access_codes/create.mdx

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ title: 'Create an Access Code'
66
- [Response](#response)
77
- [Examples](#examples)
88

9-
Creates a new [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).
9+
Creates a new [access code](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes).
1010

1111
<Tabs>
1212
<Tab title="JavaScript">
@@ -295,7 +295,7 @@ ID of the device for which you want to create the new access code.
295295

296296
**`allow_external_modification`** _Boolean_
297297

298-
Indicates whether [external modification](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#external-modification) of the code is allowed. Default: `false`.
298+
Indicates whether [external modification](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes#external-modification) of the code is allowed. Default: `false`.
299299

300300
---
301301

@@ -311,7 +311,7 @@ Code to be used for access.
311311

312312
**`common_code_key`** _String_
313313

314-
Key to identify access codes that should have the same code. Any two access codes with the same `common_code_key` are guaranteed to have the same `code`. See also [Creating and Updating Multiple Linked Access Codes](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/creating-and-updating-multiple-linked-access-codes).
314+
Key to identify access codes that should have the same code. Any two access codes with the same `common_code_key` are guaranteed to have the same `code`. See also [Creating and Updating Multiple Linked Access Codes](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes/creating-and-updating-multiple-linked-access-codes).
315315

316316
---
317317

@@ -323,25 +323,25 @@ Date and time at which the validity of the new access code ends, in [ISO 8601](h
323323

324324
**`is_external_modification_allowed`** _Boolean_
325325

326-
Indicates whether [external modification](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#external-modification) of the code is allowed. Default: `false`.
326+
Indicates whether [external modification](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes#external-modification) of the code is allowed. Default: `false`.
327327

328328
---
329329

330330
**`is_offline_access_code`** _Boolean_
331331

332-
Indicates whether the access code is an [offline access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/offline-access-codes).
332+
Indicates whether the access code is an [offline access code](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes/offline-access-codes).
333333

334334
---
335335

336336
**`is_one_time_use`** _Boolean_
337337

338-
Indicates whether the [offline access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/offline-access-codes) is a single-use access code.
338+
Indicates whether the [offline access code](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes/offline-access-codes) is a single-use access code.
339339

340340
---
341341

342342
**`max_time_rounding`** _String_
343343

344-
Maximum rounding adjustment. To create a daily-bound [offline access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/offline-access-codes) for devices that support this feature, set this parameter to `1d`.
344+
Maximum rounding adjustment. To create a daily-bound [offline access code](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes/offline-access-codes) for devices that support this feature, set this parameter to `1d`.
345345

346346
---
347347

@@ -359,7 +359,7 @@ To help your users identify codes set by Seam, Seam provides the name exactly as
359359

360360
**`prefer_native_scheduling`** _Boolean_
361361

362-
Indicates whether [native scheduling](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#native-scheduling) should be used for time-bound codes when supported by the provider. Default: `true`.
362+
Indicates whether [native scheduling](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes#native-scheduling) should be used for time-bound codes when supported by the provider. Default: `true`.
363363

364364
---
365365

@@ -377,7 +377,7 @@ Date and time at which the validity of the new access code starts, in [ISO 8601]
377377

378378
**`use_backup_access_code_pool`** _Boolean_
379379

380-
Indicates whether to use a [backup access code pool](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#backup-access-codes) provided by Seam. If `true`, you can use [`/access_codes/pull_backup_access_code`](https://docs.seam.co/latest/api/access_codes/pull_backup_access_code).
380+
Indicates whether to use a [backup access code pool](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes#backup-access-codes) provided by Seam. If `true`, you can use [`/access_codes/pull_backup_access_code`](https://docs.seam.co/latest/api/access_codes/pull_backup_access_code).
381381

382382
---
383383

mintlify-docs/api/access_codes/create_multiple.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ title: 'Create Multiple Linked Access Codes'
55
- [Request Parameters](#request-parameters)
66
- [Response](#response)
77

8-
Creates new [access codes](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) that share a common code across multiple devices.
8+
Creates new [access codes](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes) that share a common code across multiple devices.
99

1010
Users with more than one door lock in a property may want to create groups of linked access codes, all of which have the same code (PIN). For example, a short-term rental host may want to provide guests the same PIN for both a front door lock and a back door lock.
1111

1212
If you specify a custom code, Seam assigns this custom code to each of the resulting access codes. However, in this case, Seam does not link these access codes together with a `common_code_key`. That is, `common_code_key` remains null for these access codes.
1313

1414
If you want to change these access codes that are not linked by a `common_code_key`, you cannot use `/access_codes/update_multiple`. However, you can update each of these access codes individually, using `/access_codes/update`.
1515

16-
See also [Creating and Updating Multiple Linked Access Codes](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/creating-and-updating-multiple-linked-access-codes).
16+
See also [Creating and Updating Multiple Linked Access Codes](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes/creating-and-updating-multiple-linked-access-codes).
1717

1818
<Tabs>
1919
<Tab title="JavaScript">
@@ -355,7 +355,7 @@ IDs of the devices for which you want to create the new access codes.
355355

356356
**`allow_external_modification`** _Boolean_
357357

358-
Indicates whether [external modification](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#external-modification) of the code is allowed. Default: `false`.
358+
Indicates whether [external modification](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes#external-modification) of the code is allowed. Default: `false`.
359359

360360
---
361361

@@ -383,7 +383,7 @@ Date and time at which the validity of the new access code ends, in [ISO 8601](h
383383

384384
**`is_external_modification_allowed`** _Boolean_
385385

386-
Indicates whether [external modification](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#external-modification) of the code is allowed. Default: `false`.
386+
Indicates whether [external modification](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes#external-modification) of the code is allowed. Default: `false`.
387387

388388
---
389389

@@ -401,7 +401,7 @@ To help your users identify codes set by Seam, Seam provides the name exactly as
401401

402402
**`prefer_native_scheduling`** _Boolean_
403403

404-
Indicates whether [native scheduling](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#native-scheduling) should be used for time-bound codes when supported by the provider. Default: `true`.
404+
Indicates whether [native scheduling](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes#native-scheduling) should be used for time-bound codes when supported by the provider. Default: `true`.
405405

406406
---
407407

@@ -419,7 +419,7 @@ Date and time at which the validity of the new access code starts, in [ISO 8601]
419419

420420
**`use_backup_access_code_pool`** _Boolean_
421421

422-
Indicates whether to use a [backup access code pool](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#backup-access-codes) provided by Seam. If `true`, you can use [`/access_codes/pull_backup_access_code`](https://docs.seam.co/latest/api/access_codes/pull_backup_access_code).
422+
Indicates whether to use a [backup access code pool](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes#backup-access-codes) provided by Seam. If `true`, you can use [`/access_codes/pull_backup_access_code`](https://docs.seam.co/latest/api/access_codes/pull_backup_access_code).
423423

424424
---
425425

mintlify-docs/api/access_codes/delete.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: 'Delete an Access Code'
55
- [Request Parameters](#request-parameters)
66
- [Response](#response)
77

8-
Deletes an [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).
8+
Deletes an [access code](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes).
99

1010
<Tabs>
1111
<Tab title="JavaScript">

mintlify-docs/api/access_codes/generate_code.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: 'Generate a Code'
55
- [Request Parameters](#request-parameters)
66
- [Response](#response)
77

8-
Generates a code for an [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes), given a device ID.
8+
Generates a code for an [access code](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes), given a device ID.
99

1010
<Tabs>
1111
<Tab title="JavaScript">

mintlify-docs/api/access_codes/get.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: 'Get an Access Code'
55
- [Request Parameters](#request-parameters)
66
- [Response](#response)
77

8-
Returns a specified [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).
8+
Returns a specified [access code](https://docs.seam.co/latest/low-level-apis/smart-locks/access-codes).
99

1010
You must specify either `access_code_id` or both `device_id` and `code`.
1111

0 commit comments

Comments
 (0)