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.sid from POST /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 code plus a safe message — never stack traces or secrets.
  • Mutating browser calls send credentials: include and the header x-logiccore-csrf: 1.

Where to go next