Makes a homepage the preferred homepage for the specified groups or specific users. Provide either group_id or user_id query parameters — they are mutually exclusive, and supplying both returns a 400 error.

When group_id is used, the groups must be assigned to the homepage. If no groups are specified, the homepage will become the preferred homepage for all groups assigned to the homepage.

When user_id is used, the homepage is pinned directly to each specified user regardless of group assignment. Valid users have their preference set; any invalid or non-existent user IDs are reported in the failures list. If none of the supplied users could be updated, a 400 error is returned.

If the homepage is disabled, the request returns a 200 response with a warning and no preferences are set. See Group-Based Homepages for help assigning groups to homepages, enabling homepages, and working with multiple homepages.