Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: rewrite managed vs custom auth and add a guide to moving to your own OAuth app (#5321)
## What and why Managed vs custom auth said to keep managed apps in production when their branding, scopes and quotas fit, and gave no help to teams that already have users on a managed app and want to move. This PR turns the page into a decision page and adds a step-by-step guide for moving to your own OAuth app. The framing matches #5320: managed apps work in production, the shared OAuth app is why you may hit shared provider rate limits as usage grows, and your own OAuth app is a recommendation for higher volume, your own consent screen and your own scopes. ## Changes **`authentication/custom-app-vs-managed-app.mdx`**: covers what a managed app gives you, what changes with your own app (dedicated provider rate limits, your name on the consent screen, your own scopes), and when your own app makes sense. The create-auth-config steps and session wiring stay, and existing anchors are kept. **New `migration-guide/managed-to-own-app.mdx`**, "Move to your own OAuth app": - What carries over (user IDs, sessions, existing connections) and what does not. Existing users reconnect because provider tokens are bound to the client ID. - A Mermaid diagram of running both configs side by side. - Six steps: register the app, create the custom auth config, route sessions per user, reconnect users with `connected_accounts.link`, recreate triggers, and retire managed connections. - Recreating triggers keeps each trigger's config, delivery type and polling interval, maps old trigger IDs to new ones, and updates event filters before the old triggers are disabled. - Retiring connections revokes the upstream token (optional) before deleting the managed connected account. - Python, TypeScript and API tabs, plus a checklist. **`white-labeling-authentication.mdx`**: the switching section is a two-line summary that links to the guide. **`migration-guide/meta.json` and `index.mdx`**: the guide is registered. **`public/images/own-oauth-app-auth-config-form.png`**: a fresh capture of the dashboard's own-credentials form, with field placeholders only. ## Merge order The decision page and the guide link to [Avoid and recover from rate limits](/docs/poc-to-prod/avoid-rate-limits), added in #5323. Merge #5323 first. Until then `lint:links` reports those 4 links as not found. ## Checks - `bun run lint` and `check:kb` pass. - `GITHUB_ACTIONS=true bun run build` passes, including Twoslash type checks of the TypeScript snippets. - `bun run lint:links` fails only on the 4 links to the rate-limits guide (see merge order). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
No changes.