Goals & Mood Tracking (1.0.0)

Creates a new goal or updates an existing one for a user. Supports one-time and recurring goals with frequency tracking.

Used when:

• Client sets a new therapy goal
• Updating an existing goal's details or frequency
• AI-generated goals from treatment plans

Input:

• is_onetime (required): Whether this is a one-time goal
• frequency (optional): Goal frequency (auto-set to "One Time" if is_onetime=true)
• goalid (optional): Include to update an existing goal

Returns: goalid of the created or updated goal

Common errors:

• 400: Invalid parameters or unable to create goal
• 201: Goal created successfully

Updates the details of an existing goal identified by goalid in the URL path. If is_onetime is true, frequency is automatically set to "One Time". Future goal tracking entries (after today) are deleted and regenerated based on the updated schedule. Returns 204 if the goal is not found.

Soft-deletes a goal and all its associated goal tracking entries by setting is_deleted=True. Requires the goalid as a URL path parameter. Returns 204 if no goal with the given ID exists.

Accepts a JSON array of goal objects and processes them in a batch. For each item, if id is a non-zero value and the goal exists, the goal is updated; otherwise a new goal is created. Supports the same fields as the single goal endpoint, including is_onetime, frequency, targetdate, days, and reminder settings. Returns a list of all created or updated goal IDs.

Updates the reminder toggle and reminder time for an existing goal. The new reminder time is also propagated to all associated, non-deleted goal tracking entries. Requires goalid, reminder (boolean), and remindertime (HH:MM:SS) in the request body.

Returns all non-deleted goals associated with the given user ID. Each goal includes its title, frequency, criticality, reminder settings, completion status, target date, days list, and therapist approval flag.

Returns all non-deleted goals associated with the given user ID. Each goal includes its title, frequency, criticality, reminder settings, completion status, target date, days list, and therapist approval flag.

Updates the completion status of a specific goal tracking entry (goalTrackId) for a given goal (goalid in the URL path). Send iscompleted: true to mark the entry as completed, or false to unmark it. If all tracking entries for the parent goal are completed, the goal itself is also marked as "Completed". Conversely, if any entry is incomplete, the goal status is reset to null.

Accepts a userid, fromdate, todate, and optional time_zone in the request body. Returns goal tracking entries grouped by due date, with each group listing the goals scheduled for that day along with their completion status, reminder time, and tracking ID. Dates can be supplied as plain date strings (YYYY-MM-DD) or full ISO 8601 datetime strings. The response is timezone-aware; if time_zone is omitted it defaults to Etc/UTC. Returns an empty goaltracker list when no entries are found for the given range.

Creates a new mood log entry for a user. Each entry records the user ID, the date/time the mood was logged, the mood type (e.g. happy, sad, anxious), and an optional list of reasons. The create_timestamp and update_timestamp fields are set automatically.

Accepts a userid, fromdate, and todate in the request body, then returns aggregated mood statistics for that user within the given date range. The response groups entries by log date and mood type, providing a count of each mood per day alongside the associated reasons. Dates can be supplied as a plain date string (YYYY-MM-DD) or a full ISO 8601 datetime string. Returns 204 No Content when no matching records are found or when an error occurs during aggregation.

Returns all non-deleted mood log entries associated with a specific user. Use the list endpoint to retrieve all records, or the retrieve endpoint with a userid path parameter to fetch entries for a particular user. Each record includes the mood ID, user ID, log date/time, mood type, and reasons.

Returns all non-deleted mood log entries associated with a specific user. Use the list endpoint to retrieve all records, or the retrieve endpoint with a userid path parameter to fetch entries for a particular user. Each record includes the mood ID, user ID, log date/time, mood type, and reasons.

Returns all non-deleted goals for the specified user that have not yet been started (status is null) and have been approved by a therapist (is_therapist_approved=True). Each result includes the earliest due date from the associated tracking entries as startdate.

Returns all non-deleted goals for the specified user that have not yet been started (status is null) and have been approved by a therapist (is_therapist_approved=True). Each result includes the earliest due date from the associated tracking entries as startdate.