Skip to content

docs: fix integration examples, billing guidance, and stale AI exports - #261

Merged
MagMueller merged 3 commits into
mainfrom
codex/docs-production-alignment
Sep 9, 2026
Merged

docs: fix integration examples, billing guidance, and stale AI exports#261
MagMueller merged 3 commits into
mainfrom
codex/docs-production-alignment

Conversation

@MagMueller

@MagMueller MagMueller commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Fix the n8n authentication/header and V3 event examples, the Grow Therapy cache markers and cost claims, and webhook verification against the deployed Python signer. Remove the incompatible JavaScript verifier and provide a tested Python/FastAPI receiver with the exact serialization contract.

Add concurrency and billing guides covering preserved maximum legacy/spend-tier grants, project capacity, polling, queues, browser cleanup, PAYG/BYOK costs, credits, auto recharge, and soft spending caps. Remove subscription-only BYOK wording.

Replace six stale checked-in AI bundles with Mintlify-managed llms.txt and llms-full.txt. Put shared guidance in markdown.instructions, update recommended links, turn the former scoped exports into small compatibility indexes, and redirect retired Bux routes. Most deleted lines are duplicated generated bundles; the source pages remain.

Validation: Mintlify build and broken-links checks passed; 13 changed Python/JSON snippets parse; the actual initial/rerun task expressions produce the same cache template. The documented webhook verifier passes synthetic fixtures generated by the deployed sender at fdcfb4204e8e4bc58dff8870c2f230ffcedd07a9, including Unicode, numeric keys/floats, tampering, and malformed headers. No billable agent runs were needed. Mintlify preview verified automatic root exports and the new guide content. Its static asset handler bypasses page redirects for .txt, so scoped URLs use compatibility indexes instead. Public exports, pointers, and Bux redirects will also be checked after deployment.

The cache marker correction overlaps the tutorial portion of #157; that older PR also contains SDK changes and was not merged wholesale. Production API schema refresh is separate.

@mintlify

mintlify Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
browser-use 🟢 Ready View Preview Sep 9, 2026, 7:00 PM

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

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

1 issue found and verified against the latest diff

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="docs/cloud/guides/concurrency.mdx">

<violation number="1" location="docs/cloud/guides/concurrency.mdx:26">
P2: The field table documents `apiKeyId`, `concurrentSessionLimit`, and `activeSessionCount` on `GET /api/v2/billing/account`, but the checked-in `AccountView` schema in `cloud/openapi/v2.json` does not define any of those fields (only `projectId`, `totalCreditsBalanceUsd`, `rateLimit`, `planInfo`, and a few others). If the deployed response matches the spec, readers will look for fields that never appear. Verify these fields against the real endpoint and either confirm they exist or correct the table; if they are not yet deployed, do not document them as present.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic

Comment thread docs/cloud/guides/concurrency.mdx
@MagMueller
MagMueller merged commit 9d7119f into main Sep 9, 2026
7 checks passed
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