Sign in

v1

OpenAPI 3.1.02026-07-13632897.9 KB
Priority Guardian Weekly Report

Get Weekly Report

Generate a weekly report for the user.

Computes live data from Google Calendar for both current and past weeks. No persistence in this version - snapshots and aggregates are deferred.

Response includes:

  • Per-priority hours, event counts, status indicators
  • Time allocation breakdown
  • Filtered event list for LLM semantic grouping (conversational only)

Args: request: FastAPI request (for correlation ID) user_id: User ID from validated JWT (via X-User-ID header) session: Database session week_start: Optional Monday date for specific week

Returns: 200: Weekly report data 400: Invalid week_start (not Monday or invalid date format) 401: Missing/invalid X-User-ID 502: Google Calendar API error 503: Token refresh failed

get/api/priority-guardian/weekly-report

Query parameters

week_startstring nullable

Monday of the target week (ISO date: YYYY-MM-DD). Must be a Monday. If omitted, returns current week.

Monday of the target week (ISO date: YYYY-MM-DD). Must be a Monday. If omitted, returns current week.

Headers

X-Internal-Secretstring nullable
X-User-IDstring nullable

Response

Successful Response

{"stackTrail":"paths:/api/priority-guardian/weekly-report:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}