docs: update models for Codex usage reset

[tembo]

What changed

Documents the new Reset Codex usage capability in the ChatGPT Codex connection flow: when a connected ChatGPT subscription (personal or workspace) has an available usage reset, users can open the Connected dropdown next to ChatGPT Codex and select Use reset to reset eligible Codex usage limits immediately. Notes that resets are non-reversible and that workspace-scoped resets require org admin access.

Why

The Codex usage reset feature shipped in monorepo release v0.2.841 (merged PR tembo/monorepo#11324, "feat(settings): redeem Codex usage resets from connected accounts"), extending the already-documented "Connect a ChatGPT subscription" / "Connect a workspace ChatGPT subscription" flows in features/models.mdx. The docs described connecting a ChatGPT Codex subscription but had no mention of this reset capability, which is a permanent addition to the same UI.

Evidence

• Source PR: tembo/monorepo#11324 ("feat(settings): redeem Codex usage resets from connected accounts"), merged and part of monorepo release v0.2.841 (published 2026-09-14).
• Code: apps/web/components/settings/codex-reset.tsx — confirmation dialog with title "Reset Codex usage?", body "This uses one available reset to reset eligible Codex usage limits. ... This cannot be undone.", and button "Use one reset".
• Code: apps/web/components/settings/codex.tsx (~lines 364-379) — the existing "Connected" button becomes a dropdown containing a "Use reset" item, shown only when canManage is true and rateLimitResetCredits.availableCount > 0.
• Code: apps/api/src/server/routes/codexAuth.ts — new POST /codex-auth/usage/reset route that restricts organization-scope resets to admins.
• No feature-flag references were found gating this code path; the change is an ancestor of the published v0.2.841 release tag.

Confidence

High confidence: this is a fully shipped, unflagged feature that directly extends an existing, already-documented settings flow. The added text mirrors the exact UI copy from the source components and required no guessing of positioning or wording — it's inserted as a new section immediately after the two "Connect a ... ChatGPT subscription" sections it extends.

cc @benja

Want tembo to make any changes? Add a comment with @tembo and i'll get back to work!

      

---

Note

Low Risk
Documentation-only change with no runtime or security impact.

Overview
Adds a Reset Codex usage section to the Models docs, right after the personal and workspace ChatGPT Codex connection instructions.

It explains how to redeem an available subscription reset from the Connected dropdown (Use reset), that the action is immediate and irreversible, and that workspace resets are limited to org admins.

^{Reviewed by Cursor Bugbot for commit 6952df7. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated
tembo	🟢 Ready	View Preview	Sep 15, 2026, 1:18 PM

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

[tembo]

Requesting review from @DarrenBaldwin07 who has experience with the following files modified in this PR:

• features/models.mdx