# 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:

```http
Authorization: Bearer {session_token}
```

## Next Steps

- Review **Architecture** for design context
- Check **Development** for contributing guidelines