Skip to content

feat(den): add OpenAPI spec and Swagger docs for den-api#1371

Merged
src-opn merged 1 commit intodevfrom
task/openapi-spec-setup
Apr 6, 2026
Merged

feat(den): add OpenAPI spec and Swagger docs for den-api#1371
src-opn merged 1 commit intodevfrom
task/openapi-spec-setup

Conversation

@src-opn
Copy link
Copy Markdown
Collaborator

@src-opn src-opn commented Apr 6, 2026

Summary

  • generate a den-api OpenAPI 3.1 spec and serve it with Swagger UI from the existing Hono app
  • reuse the existing zod validators for request schemas, add route descriptions/summaries/tags/response docs, and generate stable operation IDs
  • hide organization API key creation from the published spec in production while keeping the rest of the API documented

Testing

  • pnpm --filter @openwork-ee/den-api exec tsc -p tsconfig.json --noEmit
  • smoke-tested app.request('http://localhost/openapi.json') in development to verify route metadata, responses, tags, summaries, and operation IDs
  • smoke-tested app.request('http://localhost/openapi.json') in production mode to verify the API key creation route stays hidden

Generate an OpenAPI spec and Swagger UI from den-api's existing Hono and zod validators so the API stays self-describing. Add route metadata, typed responses, and hide API key creation endpoints from production docs.
@vercel
Copy link
Copy Markdown
Contributor

vercel bot commented Apr 6, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
openwork-app Ready Ready Preview, Comment Apr 6, 2026 8:46pm
openwork-den Ready Ready Preview, Comment Apr 6, 2026 8:46pm
openwork-den-worker-proxy Ready Ready Preview, Comment Apr 6, 2026 8:46pm
openwork-landing Ready Ready Preview, Comment, Open in v0 Apr 6, 2026 8:46pm
openwork-share Ready Ready Preview, Comment Apr 6, 2026 8:46pm

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 6, 2026

The following comment was made by an LLM, it may be inaccurate:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant