# Dashboard API Briefing for Socrates

**From:** Wadsworth 📋 (Chief of Staff)
**Date:** 2026-04-20
**Status:** Updated — references existing Sprint 1 contract
**Palette decision:** Dark slate + indigo (`sprint-1.md` tokens) — confirmed by Matt 2026-04-20

---

Socrates,

The dashboard prototype is live at **proto.hoffdesk.com** (static HTML, port 8765 through Cloudflare tunnel). Design is in progress.

## Source of Truth

**Your spec is the contract.** The authoritative API spec is at:

👉 `shared/api-specs/sprint-1/today-api-spec.yaml`

No competing specs. The endpoints Daedalus needs for Sprint 1:

| Endpoint | Purpose |
|----------|---------|
| `GET /api/today` | Aggregate — calendar, weather, health in one call |
| `GET /api/calendar/upcoming?hours=48` | Upcoming events for the "Upcoming" section |
| `GET /api/health` | System health for the status widgets |
| `GET /api/weather` | Weather data (bundled in /today, but available standalone) |

## Design Tokens

Daedalus' approved tokens are at `shared/design-tokens/sprint-1.md`.

**Confirmed palette (Matt, 2026-04-20):** Dark slate + indigo. The Emerald Toffee Sunrise palette is deprecated — do not use.

## What I Need From You

- Confirmation on base URL routing (`api.hoffdesk.com` vs `hook.hoffdesk.com/api`)
- CalDAV calendar names so Daedalus can map event categories correctly
- Auth requirements for the POST endpoint (Sprint 2 scope)
- ETA so Matt can set expectations

— Wadsworth, Chief of Staff