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: use custom toolkit create/update and cover end-user toolkits (PLEN-4800) (#5202)
<!-- claude-projects-attribution: {"github_login":"singhbharath03"} --> _Requested by **Bharath** · [project thread](https://claude.ai/code/project/chan_01Ceg3UUAuzX7NPb6jdX94JX?thread=cmsg_01Ceg3UUAuzX7NPb6jdX94JXKauySe5WhAs9G7j9GNWF2Q)_ ## Summary The [Custom MCP guide](https://docs.composio.dev/docs/extending-sessions/custom-mcp) teaches `upsert()`, which #5195 deprecated. This PR moves the guide to `create()` / `update()`, documents toolkits that are private to one end user, and rewrites the page to be shorter and plainer (808 → ~410 lines). Linear: PLEN-4800 (sub-ticket of PLEN-4782). Designated PR reviewer: [@jkomyno](mailto:alberto@composio.dev). ## Changes - **Create a toolkit:** one `create()` / `POST /api/v3.1/custom/toolkits` example with `user_id: "all"`, followed by a table showing `auth_schemes` for no auth, API key, and DCR OAuth. `app_url`, `auth_schemes`, and `user_id` can't change after creation. - **Create a toolkit for one user:** covers `user_id`, the random slug suffix, `connect_link`, and the 409/400 rules. - **Update:** `update()` / `PATCH /api/v3.1/custom/toolkits/{slug}`, including the 2FA `user_id` rule. The logo is now a short note covering both create and update. - **Sessions:** a session only sees the custom toolkits its `user_id` can use (400 at create, 403 on execute). - **Listing:** `?user_id=` and the `access` field. - Sync, delete, and session sections are shortened. "Technical behavior" and "Known gaps" become short Troubleshooting and Limits sections. Removed the outdated "no dashboard" note. - Bumped `@composio/core` in docs to `^0.28.0`, the release with `create`/`update`. This also moves `@composio/client` from 2.0.0-rc.19 to 2.0.1. ## Type of change - [x] Documentation ## How Has This Been Tested? From `docs/`, all passing: - `bun run check:code-examples` - `bun run check:api-snippets` - `bun run check:python-snippets` - `bun run check:typescript-snippets` - `bun run lint:links` - `bun run test` (826 pass) - `tsc --strict` over the page's TypeScript fences against core 0.28.0 - `GITHUB_ACTIONS=true bun run build`, run on the first commit ## Checklist - [x] I have read the Code of Conduct and this PR adheres to it - [x] I have read and understand every line of this diff, including any LLM-generated code - [x] Any third-party docs links or promotional content follow the third-party links policy - [x] I ran linters/tests locally and they passed - [x] I updated documentation as needed - [x] I added tests or explain why not applicable (docs only; the snippet checks cover the examples) - [ ] I added a changeset if this change affects published packages (not applicable: docs only) ## Additional context Behavior is from Apollo master (`apps/apollo/src/lib/custom_toolkits/{register,schemas}.ts`, session validation in `validateSessionConfigFields.ts`). 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01H6YzWrR4j8HcSUKs9b7EhV
No changes.