fix(api): align OpenAPI contract with handlers

[buttercannfly]

Summary

• align documented statuses and response media types with API handlers and shared helpers
• document authorization, rate-limit, request-size, and generated request-binding responses across all affected routes
• tighten request schemas to match runtime validation and regenerate the API clients/server bindings
• add regression tests that traverse generated routes and handler helper calls to detect future contract drift

Validation

• go test ./packages/api/internal/api -count=1
• go test ./packages/api/internal/handlers -run TestOpenAPIIncludesHandlerContract -count=1
• go test ./packages/api/internal/middleware/ratelimit -run '^TestMiddleware_' -count=1
• go test ./tests/integration/internal/api -count=1
• npx --yes @redocly/cli lint spec/openapi.yml
• both generators are idempotent and git diff --check passes

[cla-bot]

We require contributors to sign our Contributor License Agreement, and we don't have @buttercannfly on file. You can sign our CLA at https://e2b.dev/docs/cla . Once you've signed, post a comment here that says '@cla-bot check'

[cla-bot]

We require contributors to sign our Contributor License Agreement, and we don't have @buttercannfly on file. You can sign our CLA at https://e2b.dev/docs/cla . Once you've signed, post a comment here that says '@cla-bot check'

[buttercannfly]

@cla-bot check

[cla-bot]

The cla-bot has been summoned, and re-checked this pull request!