# Brokkr — 3D Marketplace Platform
> Connect designers with local manufacturers for 3D printing and fabrication.

## What You Can Do (No Auth Required)
- Get featured designs for the homepage: GET /api/v1/homepage/featured-designs
- Get featured makers for the homepage: GET /api/v1/homepage/featured-makers
- Get a public static content page by key: GET /api/v1/content/pages/{page_key}
- Submit anonymous feedback: POST /api/v1/feedback/anonymous
- API health check: GET /api/v1/monitoring/health

## Authentication
- Get CSRF token for form submissions: GET /api/v1/csrf-token
- Create user profile after Supabase signup: POST /api/v1/users/profile

## What You Can Do (Auth Required)
- Browse and search designs: GET /api/v1/designs (customer role)
- Create a draft order: POST /api/v1/orders/draft (customer role)
- List your orders: GET /api/v1/orders (customer role)
- Request a quote for an order: POST /api/v1/orders/{order_id}/request-quote (customer role)
- List your favorite designs: GET /api/v1/customers/me/favorites (customer role)
- Upload a new design: POST /api/v1/designs (designer role)
- Start a design upload session: POST /api/v1/designs/upload-sessions (designer role)
- List draft upload sessions: GET /api/v1/designs/upload-sessions (designer role)
- Update upload session data: PUT /api/v1/designs/upload-sessions/{token} (designer role)
- Validate upload session steps: POST /api/v1/designs/upload-sessions/{token}/validate (designer role)
- Finalize and publish design: POST /api/v1/designs/upload-sessions/{token}/finalize (designer role)
- Browse design contests: GET /api/v1/contests (designer role)
- List equipment types: GET /api/v1/equipment/types
- List your material inventory: GET /api/v1/materials
- Browse equipment catalog: GET /api/v1/catalog/equipment/groups
- View your earnings summary: GET /api/v1/makers/me/earnings (maker role)
- Add equipment to your inventory: POST /api/v1/inventory/me/equipment
- List your inventory equipment: GET /api/v1/inventory/me/equipment
- Update inventory equipment: PUT /api/v1/inventory/me/equipment/{id}
- Delete inventory equipment: DELETE /api/v1/inventory/me/equipment/{id}
- Add material to your inventory: POST /api/v1/inventory/me/materials
- List your inventory materials: GET /api/v1/inventory/me/materials
- Update inventory material: PATCH /api/v1/inventory/me/materials/{id}
- Delete inventory material: DELETE /api/v1/inventory/me/materials/{id}
- Check design manufacturing compatibility against inventory: POST /api/v1/inventory/me/check-compatibility/{design_id}
- List and manage platform users: GET /api/v1/admin/users (admin role)
- List material types: GET /api/v1/admin/catalog/materials/types (admin role)
- List equipment groups: GET /api/v1/admin/catalog/equipment/groups (admin role)
- Review content moderation queue: GET /api/v1/admin/moderation (admin role)
- View platform analytics and reports: GET /api/v1/admin/analytics (admin role)

## Machine-Readable Resources
- Full API schema: /api/v1/openapi.json
- Agent capabilities: /.well-known/agent.json
- Site-level JSON-LD in root layout; per-page metadata on auth routes (expanding)

## MCP Server (Planned)
- Not yet available