Skip to content

Update endpoint pages to use remote specs. - #82

Merged
cbrinicombe13 merged 4 commits into
mainfrom
live-api-specs
Jul 28, 2026
Merged

Update endpoint pages to use remote specs.#82
cbrinicombe13 merged 4 commits into
mainfrom
live-api-specs

Conversation

@cbrinicombe13

@cbrinicombe13 cbrinicombe13 commented Jul 28, 2026

Copy link
Copy Markdown
Member

Note

Medium Risk
Wide mechanical change to how Mintlify resolves every API/webhook page; broken hosted specs or operation ID mismatches would break reference rendering in both locales.

Overview
Moves API reference off repo-local openapi/*.yml frontmatter to hosted OpenAPI wired in docs.json: Application API and Webhooks use https://api.trophy.so/v1/openapi, Admin API uses https://admin.trophy.so/v1/openapi (English and Spanish nav).

Endpoint and webhook MDX (English and es/) now use Mintlify’s inherited-spec form—e.g. openapi: "GET /users/{id}" or openapi: "webhook points.changed"—instead of openapi: openapi/application.yml get /path. i18n.lock updates reflect the new meta/openapi values.

Docs workflow: README and .cursor/rules/localization-workflow.mdc describe hosted specs and the new frontmatter rules; README notes translate:sync-openapi-titles reads summaries from hosted OpenAPI.

Spanish nav fix: docs.json adds the missing Application API Keys group under Spanish Admin API so it matches English.

Reviewed by Cursor Bugbot for commit e367fb2. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Jul 28, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
trophy 🟢 Ready View Preview Jul 28, 2026, 9:58 AM

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

Comment thread admin-api/endpoints/attributes/create-attributes.mdx Outdated

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 3dcc55a. Configure here.

Comment thread docs.json
@cbrinicombe13
cbrinicombe13 merged commit c75661a into main Jul 28, 2026
4 of 5 checks passed
@cbrinicombe13
cbrinicombe13 deleted the live-api-specs branch July 28, 2026 10:35
@mintlify

mintlify Bot commented Jul 28, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
trophy 🟡 Building Jul 28, 2026, 9:57 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.

1 participant