Submit a merge request that closes this issue to earn points on merge — bounties stack on the standard +40 merge_pr award. New to the repo? See the Contributing guide, and Local Development & SSO to run the app locally (cp .dev.vars.example .dev.vars && pnpm dev, after rebasing on main) and fully test your change before opening the MR.

Description

Context

Developers don't know what endpoints each Worker exposes without reading source. Build a tool that ingests each app's wrangler.toml and source files and emits a one-page API reference with copy-paste TypeScript / curl examples.

Acceptance criteria

  • [ ] /apis page lists all 12 Workers with click-to-expand endpoint summary
  • [ ] For each endpoint: method, path, body schema (Zod), example response
  • [ ] Snippets generated at build time from a registry, not scraped at runtime
  • [ ] Updates trigger automatically when new endpoints land

Technical hints

  • Existing pattern of registering routes in each app's index.ts if (pathname === '/...' && method === ...) is parseable but ugly. Better: standardize a routes.ts per app and have the developer-portal build read it.
  • OpenAPI 3.1 emitter would be overkill here — keep it simple

--- *Submit a merge request that says Closes #<this issue iid> in the description. On merge to main, the GitLab webhook will auto-award your bounty + the standard merge_pr (40 pts) to your scoreboard account. Email on commit must match your Authentik email.*

Relevant files

No relevant files linked yet.

Hints

No hints yet.

Activity

No points have been awarded for this bounty yet.

Comments

No comments yet. Be the first to weigh in.

↑ Top