Developers
Browse generated CentraKit API reference pages from the committed OpenAPI specification.
The CentraKit API reference is generated from apps/api/public/openapi.json and published as generated pages under /openapi/*.
apps/api/app/api/v1.apps/api/public/openapi.json.packages/api-client/src/generated.Run the OpenAPI generation workflow after route JSDoc or schema changes so the spec, docs, and client stay aligned.
pnpm openapi:generateTo check committed artifact drift locally:
pnpm openapi:generate
git diff --exit-code -- apps/api/public/openapi.json packages/api-client/src/generatedCentraKit uses the openapi-gen CLI and typed openapi-gen.config.mts configuration from next-openapi-gen. This release does not adopt Overlay, Arazzo, or the generator's clientSdk emitter; those remain deferred while Zod and Hey API continue to own their existing parts of the pipeline.
@hey-api/openapi-ts 0.99 still requires the classic TypeScript compiler API, so generation redirects typescript imports to the isolated typescript6 package through module.registerHooks(). That exception is generation-only: the committed generated output is checked by the repository TypeScript 7 compiler with inherited strict settings, including exactOptionalPropertyTypes.
Hey API 0.99's generated fetch runtime passes explicit undefined for a small set of optional request and stream fields. Until the upstream templates omit those fields, generation runs a narrow compatibility transform over only the generated client and core runtime files. The transform replaces the known assignments with conditional property inclusion, is idempotent, and fails generation if the expected upstream patterns drift. Generated SDK functions, domain types, and Zod schemas are not rewritten.
requestApiOperation intentionally accepts a runtime operation ID for the CLI's generic API command. Hey API emits strongly typed functions and operation-specific options in apiSdk, but does not emit a single operation-ID metadata map that could type this dynamic wrapper without maintaining a duplicate catalog.