---
class: technical
---

# Brief: Add User Preferences API Endpoint

## Source PRD

mosaic-stack PRD — Mission Control Dashboard

## Scope

Add a REST endpoint for storing and retrieving user dashboard preferences (layout, theme, sidebar state). This enables the Mission Control dashboard to persist user customization.

## Success Criteria

1. GET /api/users/:id/preferences returns stored preferences (JSON)
2. PUT /api/users/:id/preferences stores/updates preferences
3. Preferences persist across sessions
4. Default preferences returned for users with no stored preferences
5. Only the authenticated user can read/write their own preferences

## Estimated Complexity

Medium — new endpoint, new DB table, auth integration

## Dependencies

- Requires existing auth system (JWT guards)
- Requires existing user entity in database