Files
Jason Woltje dedc1af080
All checks were successful
ci/woodpecker/push/infra Pipeline was successful
ci/woodpecker/push/web Pipeline was successful
ci/woodpecker/push/api Pipeline was successful
fix(auth): restore BetterAuth OIDC flow across api/web/compose
2026-02-17 23:37:49 -06:00
..

API Reference

Complete API documentation for Mosaic Stack backend.

Chapters

  1. Conventions — API design patterns, endpoints, and response formats
  2. Authentication — Auth endpoints and type definitions

API Standards

  • REST Conventions: Standard HTTP methods and status codes
  • Type Safety: All requests/responses typed via @mosaic/shared
  • Error Handling: Consistent error response format
  • Authentication: Bearer token via Authorization header

Base URL

  • Development: http://localhost:3001
  • Production: Configure via NEXT_PUBLIC_APP_URL

Authentication

All authenticated endpoints require:

Authorization: Bearer {session_token}

Next Steps

  • Review Architecture for design context
  • Check Development for contributing guidelines