Uh oh!
There was an error while loading. Please reload this page.
docs(SOL-316): host the legacy unified apis moved from docs - #397
Merged
Conversation
- 271 pages: legacy-unified-apis, hris, ats, crm, lms, accounting, integration-guides - includes 193 generated api-reference pages + the 5 per-category openapi specs - 27 snippets: 8 moved, 7 forked (docs still uses them for iam/documents/permissions-check) - 361 images; 2 renamed where hub-docs already had a different file at that path - nav: new Legacy Unified APIs tab using anchors per category - port scripts/update-oas.ts + oas-update.yml, scoped to the 5 moved categories - legacy notice snippet on all 6 entry pages - fix 21 pre-existing <Frame>-in-table-cell parse errors that broke 3 pages Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Contributor
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
- ATS, CRM, LMS, Accounting each get a parent group rooted at their introduction - group names taken from each page's own title, so they cannot drift - API Reference stays a sibling of the parent group, as on HRIS Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
- recruitee: #partnership-requirements -> #partner-requirements - sapsuccessfactors assessment + background check: 3 anchors pointed at <Accordion> titles, which get no anchor, so repoint them at the enclosing heading - docebo: the tin can blog post 404s, link the Tin Can API spec instead All four predate the move and are broken on docs today. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Replaces the 404ing tin can blog post with the Docebo help centre article. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
faisalreza-stackone
requested review from
a team
and
a balanced review from CopilotAugust 14, 2026 09:58
Uh oh!
There was an error while loading. Please reload this page.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Moves the Legacy Unified APIs documentation here from the docs repo, so it stays available for existing integrations while the main documentation site moves on. Pairs with StackOneHQ/docs#1083, which removes the same content and redirects the old URLs here.
Merge this one first. The docs pull request points
docs.stackone.comat these pages, so if that merges first those redirects lead nowhere.Ticket: SOL-316
What moved
legacy-unified-apis/,hris/,ats/,crm/,lms/,accounting/andintegration-guides/api-reference/folderiam/,documents/andpermissions-check/Every page kept its path, so
docs.stackone.com/hris/introductionbecomeshub.stackone.com/hris/introduction.Navigation
A new Legacy Unified APIs tab, with one anchor per category. The existing three pages stay in a Hub Guides tab, and the 82 existing redirects are untouched.
Keeping the API reference current
scripts/update-oas.tsis ported from the docs repository and scoped to the five categories that moved, with a dailyoas-update.ymlworkflow that opens a pull request when the specifications change. The docs repository dropped those five from its own copy, so the two jobs do not overlap.This adds a
package.jsonand lock file to a repository that had neither, because the workflow runsnpm ci.Two things worth a look
Three pages were already broken before this move.
integration-guides/ats/sapsuccessfactors-assessment,integration-guides/ats/teamtailor-partner-apiandintegration-guides/lms/external-content-providers/workdayeach had<Frame>blocks split across lines inside markdown table cells, which MDX cannot parse, so all three failed to build and returned a not-found error ondocs.stackone.com. Verified by validating the untouched originals from the docs repository, which fail identically. Fixed by collapsing 21 of those blocks to inline images, the only image form a table cell accepts.A self-referencing link is fixed. The webhooks snippet said "start with the main Webhooks guide" and linked to the page it renders on. It now points at the current Webhook Events guide.
Checks
mint validatepassesmint broken-linksreports no broken linksNote for reviewers
Running any
mintcommand in two documentation repositories at the same time is unreliable, because~/.mintlify/mintis a shared working directory and the second run switches which project the first one serves.🤖 Generated with Claude Code