Aegis Health

GET /health/summary

Health summary for a given period.

Query params: user_id (default), days (default 7).

web_fetch("http://data-api:8000/health/summary?user_id=default&days=7", {
  "headers": {"Authorization": "Bearer $DATA_API_TOKEN"}
})

GET /health/trends

Trends for a specific metric type over time.

Query params: user_id (default), metric_type (e.g. steps, protein_g, sleep_hours), days (default 30).

web_fetch("http://data-api:8000/health/trends?user_id=default&metric_type=protein_g&days=14", {
  "headers": {"Authorization": "Bearer $DATA_API_TOKEN"}
})

GET /health/goals

Today's metrics compared against configured health goals.

web_fetch("http://data-api:8000/health/goals?user_id=default", {
  "headers": {"Authorization": "Bearer $DATA_API_TOKEN"}
})

GET /health/macros

Macro breakdown (protein, carbs, fat, calories) versus daily targets.

web_fetch("http://data-api:8000/health/macros?user_id=default", {
  "headers": {"Authorization": "Bearer $DATA_API_TOKEN"}
})

GET /health/weekly

Weekly health summaries with daily breakdowns.

Query params: user_id (default), weeks (default 4).

web_fetch("http://data-api:8000/health/weekly?user_id=default&weeks=4", {
  "headers": {"Authorization": "Bearer $DATA_API_TOKEN"}
})

POST /health/ingest

Ingest health data (from Apple Health exports, iOS Shortcuts, or manual entry).

web_fetch("http://data-api:8000/health/ingest", {
  "method": "POST",
  "headers": {"Authorization": "Bearer $DATA_API_TOKEN", "Content-Type": "application/json"},
  "body": "{\"user_id\": \"default\", \"metrics\": [{\"metric_type\": \"steps\", \"value\": 8500, \"unit\": \"count\", \"source\": \"apple_health\", \"timestamp\": \"2026-02-28T18:00:00Z\"}]}"
})

POST /health/sync

Trigger a Garmin health data sync.

web_fetch("http://data-api:8000/health/sync?user_id=default", {
  "method": "POST",
  "headers": {"Authorization": "Bearer $DATA_API_TOKEN"}
})

Guidelines

Daily Goals

Refer to USER.md for personalized targets (protein, calories, steps, sleep, water). Always use the user's configured goals rather than hardcoded values.

Progress Reporting

Always show actuals vs goals: "112g / 175g protein (64%) -- 63g more needed."

• On track (80%+ by proportional time of day): report positively.
• Behind: note deficit and suggest catch-up (e.g., "A chicken breast and a protein shake would cover it").
• Over limit (calories): flag clearly without judgment.

Trend Analysis

Fetch 7-day data via GET /health/summary?days=7. Calculate averages, compare to goals, identify patterns ("You consistently fall short on protein on weekends").

Time-of-Day Context

• Morning: focus on goals for the day, lunch planning for protein.
• Afternoon: show progress, estimate dinner needs.
• Evening: summarize the day, note final deficits.

Nutrition Notes

• Protein is a priority goal. Suggest high-protein foods when behind.
• The calorie limit is an intentional deficit. Do not suggest eating more unless asked.
• NEVER provide medical advice. Report data and compare to stated goals only.

Error Handling

• 401 Unauthorized -- Bearer token missing or invalid
• 404 Not Found -- Resource doesn't exist
• 422 Validation Error -- Invalid request parameters
• 500 Internal Server Error -- Integration failure; retry after sync