/**
 * @example
 *     {
 *         values: {
 *             "Favorite Color": "blue",
 *             "Age": 30,
 *             "Is Student": false,
 *             "Hobbies": [
 *                 "reading",
 *                 "cycling"
 *             ]
 *         },
 *         user_groups: ["marketing", "developers"]
 *     }
 *
 * @example
 *     {
 *         values: {
 *             "user_profile": {
 *                 "first_name": "Alice",
 *                 "last_name": "Johnson",
 *                 "contact_info": {
 *                     "email_address": "alice@example.com",
 *                     "phone_number": "555-0123"
 *                 }
 *             },
 *             "account_settings": {
 *                 "is_premium_user": true,
 *                 "subscription_tier": "gold",
 *                 "preferences": [
 *                     "email_notifications",
 *                     "sms_alerts"
 *                 ]
 *             },
 *             "account_balance": 1250.75
 *         },
 *         user_groups: ["marketing", "developers"]
 *     }
 *
 * @example
 *     {
 *         values: {
 *             "Company Name": "Acme Corp",
 *             "company_details": {
 *                 "founded_year": 2020,
 *                 "employee_count": 150,
 *                 "headquarters": {
 *                     "city": "San Francisco",
 *                     "state": "CA",
 *                     "country": "USA"
 *                 }
 *             },
 *             "Is Public": false,
 *             "tags": [
 *                 "tech",
 *                 "startup",
 *                 "saas"
 *             ]
 *         },
 *         user_groups: ["marketing"]
 *     }
 */
export interface UpdateValuesRequest {
    /** A dictionary of keys and values to update or add. Supports both flat key-value pairs and nested objects. Nested objects will be automatically flattened using dot notation with readable key names (e.g., 'user.contact_info.email' becomes 'User.Contact Info.Email'). */
    values: Record<string, unknown>;
    /** Optional array of user group names or IDs. If omitted and user belongs to user groups, values will be assigned to all user's user groups. Required if values should be restricted to specific user groups. */
    user_groups?: string[];
    /** Optional metadata keyed by dynamic value name. This is the canonical snake_case field; legacy clients may still send `metadataByName`. */
    metadata_by_name?: Record<string, Record<string, unknown>>;
}