AgoraFitness

Get Most Recent 7 Day Logs

Retrieve the 7 most recent day logs for a specific user, sorted by date descending. Each day log includes macro targets, zones (fasting/eating windows), timeline blocks (meals, training, supplements), extra activities, and morning check-in data.

Get Most Recent 7 Workouts

Retrieve the 7 most recent workout logs for a specific user, sorted by date descending. Each workout includes blocks (warmup, main, etc.), exercise groups, exercises with logged sets, duration, feeling, notes, and a summary of total sets/reps/volume.

Get Nutrition Plans

Retrieve all nutrition plans for a specific user and GPT ID.

Get Summaries

Retrieve all summaries for a specific user email and GPT ID.

Get Today Context

Retrieve the user's daily context for a specific date (YYYY-MM-DD): the day log, the workout log, and the current user profile. Unlike get_user_context, the day log and workout are fetched strictly for the requested date — pass today's date to get today's context. today_log and today_workout are null if no log exists for that date. The profile includes goals (metric or achievement) and preferences. Use this when you only need today's nutrition tracking, today's training, and the profile, without

Get Today Daylog

Retrieve a single day log for a specific user and date (YYYY-MM-DD). Pass the current date as 'date' to fetch today's log. Returns null in day_log if no log exists for that date. Use this instead of get_user_context or get_most_recent_7_day_logs when you only need today's nutrition tracking (meals, macros, timeline blocks, zones, activities, morning check-in).

Get User Checkins

Retrieve previous user checkins for a specific user. Returns checkin history including weight tracking and notes.

Get User Context

Retrieve aggregated user context including profile (with user goals), previous conversations (summaries), user programs, nutrition plans, and the most recent day log for a specific user and GPT ID. The profile includes goals which can be either metric goals (weight, body fat, PRs with target values and dates) or achievement goals (general accomplishments with title and description). Each goal has a status (active, completed, paused, cancelled). The day log contains the user's daily nutrition tra

Get User Programs

Retrieve all fitness programs for a specific user and GPT ID.

Save User Program

Save a generated fitness program for a user.

Update Day Log

Update a user's day log for a specific date. Day logs track daily nutrition including meals, macros, timeline blocks (meals, training, supplements), zones (fasting/eating windows), and activities. Use this to update meal logging, supplement tracking, training sessions, and other daily activities. The day log is identified by user_email and date (YYYY-MM-DD format).

User Checkin

Save a user checkin. Records user progress data including weight, date, and notes.