service

api-v2 (target)

Target backend application. Source of the formal HTTP API contract via generated OpenAPI. EventCatalog renders the spec on this page.

ServiceTargetDeployableStatus: Implemented in api-v2Buildplan API v2

Overview

This service represents the target backend. The OpenAPI tab on this page renders the spec generated from Zod schemas in apps/api-v2.

Source of Truth

  • API contract: apps/api-v2/openapi/openapi.json (generated)
  • Runtime: apps/api-v2 (Express, Zod, Prisma)
  • Architecture conventions: eventcatalog/CONVENTIONS.md

Documentation Policy

Generated OpenAPI is the source of truth for HTTP paths, methods, parameters, request bodies, response bodies, errors, authentication, tags, and operation IDs.

EventCatalog provides the surrounding context: domain ownership, service boundaries, migration status, commands, queries, events, and flows.

Edit this page