Skip to content

Fix Scan API 404 and consolidate endpoint navigation#709

Draft
8bitpal wants to merge 2 commits into
mainfrom
issue-698-scan-api-single-page
Draft

Fix Scan API 404 and consolidate endpoint navigation#709
8bitpal wants to merge 2 commits into
mainfrom
issue-698-scan-api-single-page

Conversation

@8bitpal

@8bitpal 8bitpal commented Jun 9, 2026

Copy link
Copy Markdown
Collaborator

Summary

Fixes the broken /reference/splice-scan-api/common/readyz link and consolidates the Scan API navigation.

Changes

openapi/splice/scan/scan.yaml — adds the missing common tag definition:

  • /readyz, /livez, /status, /version were already tagged common in the paths, but common was absent from the top-level tags array
  • Without the tag definition, Mintlify could not generate those pages, causing the 404 at /reference/splice-scan-api/common/readyz

docs-main/docs.json — removes the 71-entry explicit pages list from the Scan API nav block:

  • The spec already groups endpoints by tag (common, external, internal, deprecated, pre-alpha)
  • With no pages override, Mintlify auto-generates the sidebar from those tags — giving a grouped, browsable view rather than a flat alphabetical list
  • Individual endpoint pages remain fully accessible via URL

api-reference.mdx / splice-scan-openapi.mdx — minor description and clarity updates to those two pages.

Closes #698

- Add 'common' tag definition to scan.yaml so /readyz, /livez, /status,
  /version generate pages at /reference/splice-scan-api/common/{path}
- Remove explicit 71-entry pages list from docs.json Scan API block;
  Mintlify now auto-generates nav from spec tags, giving a grouped view
  instead of a flat list of individual endpoint entries
- Update description on the Splice APIs card in api-reference.mdx
- Clarify tag structure in splice-scan-openapi.mdx
@mintlify

mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
cantonfoundation 🟢 Ready View Preview Jun 9, 2026, 7:59 AM

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Issue on docs

1 participant