feat: merge access grant pages & add access method guides by dawnho · Pull Request #1127 · seamapi/docs

dawnho · 2026-06-10T00:39:13Z

Summary

Merge three "Creating an Access Grant" pages into one — consolidates the separate "Using Devices", "Using Spaces", and "Using Entrances" pages into a single page with subsections, eliminating ~70% content duplication
Add four new access method guide pages — Using PIN Codes, Using Mobile Keys, Using Instant Keys, and Using Key Cards (with encoding/assigning subsections)
Updates all cross-references across both Mintlify and GitBook content systems
Adds redirects for old URLs in .gitbook.yaml and docs.json

Test plan

Verify merged "Creating an Access Grant" page renders correctly on Mintlify dev server
Verify all four new access method pages render correctly
Confirm old URLs redirect properly
Check cross-references from quickstart, access-grant-quick-start, and index pages

🤖 Generated with Claude Code

mintlify · 2026-06-10T00:39:36Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
seam	🟢 Ready	View Preview	Jun 10, 2026, 12:42 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

The override-based access systems note is about grant creation, not access methods. Give it its own section below the Access Methods table. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Explain that override-based systems require it for credential sequencing, while other systems use it to reuse the same PIN across multiple Access Grants. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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

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

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

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

Each "Using ..." page now shows how to call /access_methods/get_related to list which devices and entrances an access method covers. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Old redirects pointed to deleted pages; our new redirects point to the restructured pages. Mintlify requires each source path to be unique. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

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

Each delivery page now has a "List the Doors This X Applies To" step that explains an access method can cover multiple doors and shows how to see which ones. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

"See Which Doors an Access Method Covers" — not a required step. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

… guide The "See Which Doors an Access Method Covers" section now appears before "Step 3: Unlock the Entrance" since users need to know which doors a cloud key covers before triggering an unlock. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Updated mintlify-docs/use-cases/granting-access/reservation-access-grants.mdx - Updated mintlify-docs/use-cases/granting-access/using-cloud-keys.mdx Mintlify-Source: dashboard-editor

…ry pages Switch the "Retrieve the PIN Code", "Deliver the Mobile Key", and "Deliver the Key Card" steps to use access_methods.list({ access_grant_id }) instead of access_methods.get() with nested ID lookups. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Updated mintlify-docs/use-cases/granting-access/reservation-access-grants.mdx - Updated mintlify-docs/use-cases/granting-access/using-cloud-keys.mdx - Updated mintlify-docs/use-cases/granting-access/using-pin-codes.mdx - Updated mintlify-docs/use-cases/granting-access/using-instant-keys.mdx - Updated mintlify-docs/use-cases/granting-access/using-mobile-keys.mdx - Updated mintlify-docs/use-cases/granting-access/using-key-cards.mdx Mintlify-Source: dashboard-editor

These were incorrectly copy-pasted from the encode section — they called access_methods.encode instead of access_methods.assign_card and passed acs_encoder_id instead of card_number. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

All five delivery pages (PIN codes, mobile keys, key cards, cloud keys, instant keys) had get_related code blocks with only JS, Python, and cURL. Added the four missing languages to each. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

dawnho requested review from a team as code owners June 10, 2026 00:39

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 00:42 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:25 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:26 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:27 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:28 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:30 View deployment

dawnho force-pushed the feat/access-method-pages branch from 8e04773 to 61fc6ad Compare June 10, 2026 06:36

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:37 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:39 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:46 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:47 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:48 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 06:49 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 07:01 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 07:02 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 07:04 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 07:07 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 07:08 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 07:09 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 07:10 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 07:15 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 17:06 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 17:07 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 17:39 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 17:43 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 18:04 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 18:15 View deployment

dawnho and others added 6 commits June 10, 2026 12:39

feat: move reservation callout to its own section on overview page

145bc5a

The override-based access systems note is about grant creation, not access methods. Give it its own section below the Access Methods table. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: expand reservation_key section with both use cases

456e3d9

Explain that override-based systems require it for credential sequencing, while other systems use it to reuse the same PIN across multiple Access Grants. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: note that same user_identity_id reuses access methods across gr…

714980a

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

fix: remove incorrect reservation_key bullet for non-override systems

ba0afb9

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

feat: rename reservation section to "Special Cases for Hotel Access S…

6a155ad

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

feat: rename section to "Hotel and Offline Lock Systems"

09ee181

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

dawnho force-pushed the feat/access-method-pages branch from 9be7418 to 09ee181 Compare June 10, 2026 19:39

dawnho and others added 3 commits June 10, 2026 12:50

feat: add get_related section to all delivery pages

142c644

Each "Using ..." page now shows how to call /access_methods/get_related to list which devices and entrances an access method covers. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

fix: remove duplicate redirect sources in docs.json

262e3e2

Old redirects pointed to deleted pages; our new redirects point to the restructured pages. Mintlify requires each source path to be unique. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

fix: mobile keys and instant keys only relate to ACS entrances, not d…

e3289cf

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

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 19:54 View deployment

feat: make get_related a numbered step and explain why you need it

1434620

Each delivery page now has a "List the Doors This X Applies To" step that explains an access method can cover multiple doors and shows how to see which ones. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 19:55 View deployment

feat: rename get_related section to informational heading

75724a3

"See Which Doors an Access Method Covers" — not a required step. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 19:56 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 19:57 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 20:01 View deployment

Updated mintlify pages

7728ac7

- Updated mintlify-docs/use-cases/granting-access/reservation-access-grants.mdx - Updated mintlify-docs/use-cases/granting-access/using-cloud-keys.mdx Mintlify-Source: dashboard-editor

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 20:03 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 20:13 View deployment

dawnho and others added 2 commits June 10, 2026 13:32

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 20:34 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 20:35 View deployment

mintlify Bot deployed to staging - mintlify-docs June 10, 2026 20:36 View deployment

dawnho merged commit 49fbd48 into main Jun 10, 2026
12 checks passed

dawnho deleted the feat/access-method-pages branch June 10, 2026 20:39

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: merge access grant pages & add access method guides#1127

feat: merge access grant pages & add access method guides#1127
dawnho merged 36 commits into
mainfrom
feat/access-method-pages

dawnho commented Jun 10, 2026

Uh oh!

mintlify Bot commented Jun 10, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

dawnho commented Jun 10, 2026

Summary

Test plan

Uh oh!

mintlify Bot commented Jun 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

mintlify Bot commented Jun 10, 2026 •

edited

Loading