Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
fix(docs): generate one overview page per webhook tag (#5454)
## Summary The pages in the [Webhook Events](https://docs.composio.dev/reference/api-reference/webhook-events) section of the API reference are generated from an OpenAPI spec that the backend publishes. `generate-api-index.ts` builds the section's overview page from the same spec, and it assumes every webhook in the spec belongs to that one section. If the spec splits webhooks across two sections, the script errors out. The backend is about to add webhook pages that belong in a second section. This PR lets the script build one overview page per section. It has to merge before that backend change ships, or the next docs data sync fails. Ticket: [PLEN-4997](https://linear.app/composio/issue/PLEN-4997) ## Changes - `scripts/generate-api-index.ts` builds an overview page for each section instead of exactly one. It still fails loudly if a page has no section, or names one the spec doesn't declare. - The individual webhook pages needed no change. Fumadocs already places them by section. - Comments updated in the script and `lib/openapi.ts`. ## Type of change - [ ] Bug fix - [ ] New feature - [x] Refactor/Chore - [x] Documentation - [ ] Breaking change ## How Has This Been Tested? - New test in `tests/static/api-deprecation.test.tsx`: webhook pages in two sections produce two overview pages, each listing only its own pages. - Running `bun run generate:api-index` on today's spec changes nothing. - `bun run types:check` and `bun run lint` pass. - `bun run test`: 833 pass, 5 fail. The same 5 page-freshness tests fail on a clean `next` checkout locally, so they're unrelated. They pass in CI. ## Checklist - [ ] I have read the Code of Conduct and this PR adheres to it - [ ] 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](https://github.com/ComposioHQ/composio/blob/next/CONTRIBUTING.md#third-party-links-in-docs) - [x] I ran linters/tests locally and they passed - [x] I updated documentation as needed - [x] I added tests or explain why not applicable - [ ] I added a changeset if this change affects published packages (docs only, not needed) 🤖 Generated with [Claude Code](https://claude.com/claude-code)
No changes.