REST API overview
What lives under /api/v1 today and what stays internal.
Source: apps/docs/content/rest-api.md
REST API overview
LogicCore exposes a versioned JSON API under /api/v1. The Next.js web app proxies /api/* to the NestJS server so browser clients stay on one origin.
What is public vs internal
- Operator APIs (identity, memberships, roles, permissions) require an admin session (
lc.sidfromPOST /api/v1/auth/admin/login). - Client APIs (project requests, portal profile) require a portal session.
- Internal admin routes stay behind the operator session. They are not an integrator contract.
A browsable OpenAPI explorer will ship with the integrator program (ADR-039). Until then this portal plus ADR-032 are the contract summary.
Conventions
- JSON bodies, camelCase fields.
- Errors return a stable
codeplus a safe message — never stack traces or secrets. - Mutating browser calls send
credentials: includeand the headerx-logiccore-csrf: 1.
Where to go next
- Authentication
- HTTP API (REST) (ADR-032)