API Revisions

2022-11-19 View
  • Added `/addfiles`, `/addfilelink`, and `/deletefile` endpoints.
2022-09-23 View
  • Improved the documentation for all of the database objects.
  • Fixed some issues with exporting of `extra_member_data_columns` in group objects and `extra_member_data` in member objects.
  • Added preliminary support for setting `extra_member_data` information via the `/updatemember` endpoint.
2022-07-15 View
  • Added `account_notify` field to the `member_info` struct, corresponding to the new Account notification setting.
2022-05-20 View
  • Fixed `end_date` documentation for `/getactivitylog` endpoint.
  • Erroneously, the `/getactivitylog` endpoint would not allow subgroups.
  • Changed `today` parameter to `last_24_hours` for the `/getactivitylog` endpoint.
2022-05-20 View
  • New `default_color` parameter for the `/updategroup` endpoint.
  • New `color` parameter for the `/updatemember` endpoint.
  • Changed color names to make them more consistent. All color names now start with `color_`. This affects color names that used to start with `tag_` and `column_color_`.
2021-09-10 View
  • Fixed `sub_group_access` documention to the `/update_group` endpoint documention.
  • Changed the `subgroup_access` field to `sub_group_access` on the group object to be consistent with other uses of the term.
  • Changed the `subgroupcategoryid` field to `sub_group_categoryid` on the group object to be consistent with other uses of the term.
  • Fix `sort_field` for `/searcharchives` endpoint.
2021-09-03 View
  • Added `description` parameter to the `/addphotos` endpoint.
2020-10-02 View
  • Added endpoints to get and manipulate pending messages, including `/getpendingmessages`, `/claimpendingmessage`, `/deletependingmessages`, `/rejectpendingmessages`, `/approvependingmessages`. NOTE: These endpoints are still under development.
2020-08-07 View
  • Added `polls_visible` field to `perms` object.
2020-07-17 View
  • Added `trial_group` field to `group` object.
2020-07-10 View
  • Added `/getorg` endpoint.
  • Added `display_name`, `user_name`, `profile_photo_url`, `profile_privacy`, `email` fields to `album` object.
  • Changed `/registerdevice` endpoint to `/addpushsub`.
  • Added `/getpushsubs`, `/deletepushsub`, and `/deleteallpushsubs` endpoints.
  • Added `appleloginstart` and `appleloginfinal` endpoints to implement Apple Sign In.
  • Added `chat_notify`, `photo_notify`, `file_notify`, `wiki_notify`, `database_notify` fields to `memberinfo` object.
2020-06-12 View
  • Added `default_hashtag_view` field to the user object, which can be set using the `/updateuser` endpoint.
2020-05-22 View
  • Added `/getenterpriseinfo` endpoint.
2020-05-01 View
  • `/getevent` wasn't obeying the group calendar permissions setting.
2020-04-03 View
  • Added `/newgroupalias` and `/deletegroupalias` endpoints.
  • Added `/unbanmember` endpoint.
2020-03-27 View
  • Removed `bcc_me` parameter from `/postdraft` as that was unused.
  • Fixed bug when changing a subgroup's name using `/updategroup`.
  • `/newdraft` endpoint now supports `draft_type_post_to_sub` draft_type.
2020-03-20 View
  • Added `default_country` field to `Database Column` object.
  • Added `description` field to `Database Column` object.
  • Added `/getactivitylog` endpoint.
  • The docs incorrectly left off the `/get` prefix for the `subgroupcategories` endpoints.
2020-03-13 View
  • Fixed sort for `/getmembernotices` endpoint.
  • Added `email_address` field to `group` object.
2020-03-06 View
  • Most endpoints now support the `extended=true` parameter.
  • Endpoints `/unbounceuser`, `/deleteprofilephoto`, `/resendconfirmationemail` now require a POST request along with `csrf` token.
  • Added additional documentation around `extended=true` parameter.
  • Added `token` option to `/login` endpoint.
  • Added `bouncing` option for `type` parameter of `/getmembers` endpoint.
2020-02-28 View
  • Added `/searchmemberdirectory` endpoint.
  • Added `body` field to `message_search_result` object.
  • Removed the `invalid posterid` error from `/searcharchives` to allow people to search for messages from people who are no longer members of the group.
  • Added `default_hidden` field to the `Database Column` object.
  • Added `id_default_hidden` and `updated_default_hidden` fields to the `Database Table` object.
2020-02-21 View
  • Added "bad_request": "no space" errors to `/addphotos`, `/updatephoto` and `/addfiles` endpoints.
  • Added support for `extended=true` to all the drafts endpoints.
  • `/updatemember` can now return: "bad_request": "moderators cannot change role of owners" is returned if a non-owner attempts to change the `mod_status` field of an owner.
  • `/updatemember` can now return: "bad_request": "moderators cannot make members owners" is returned if a non-owner attempts to make a member an owner.
  • `/updatemember` can now return: "bad_request": "moderators cannot change owner subscription settings" is returned if a non-owner attempts to change an owner's subscription settings.
2020-02-07 View
  • Removed `create_sub_group` parameter from the `/creategroup` endpoint.
2020-01-31 View
  • Added `start_time` parameter to `/downloadarchives` endpoint.
  • Updated docs on `/updategroup` endpoint, adding some missing parameters.
  • New restriction on the `/updategroup` endpoint: a group that is not restricted cannot have a `members_visible` value of `group_view_members_subs`, unless it is a subgroup and the parent group is restricted.
2020-01-17 View
  • The `message` object now has an `attachments` array.
  • The docs for `/createhashtag` incorrectly stated that `description` was required.
  • `/downloadarchives` now supports `start_msg_num` parameter.
  • `/newdraft` now supports `draft_type_dm`.
  • Added `moderate_first_message` to `group` object.
2020-01-10 View
  • Changed `moderated` field to `moderation` in the `group` object.
2019-12-27 View
  • Added `plan` field to `group` object.
  • Added `nice_group_name`, `cover_photo_url`, `icon_url`, `subs_count`, `most_recent_message` fields to the `member_info` object.
  • Changed the sort options for the `/getsubs` endpoint and added the `set_home_page` parameter.
2019-12-20 View
  • First pass at `/getdatabaserows` endpoint.
  • Added `is_reply` field to `Message` object.
  • Added `/getdatabases` endpoint.
2019-12-13 View
  • Added `/mutehashtag`, `/unmutehashtag`, `/followhashtag`, and `/unfollowhashtag` endpoints.
2019-12-06 View
  • Added `create_hashtags` permission.
  • Added `/newhashtag`, `/updatehashtag`, `/deletehashtag` endpoints.
  • Added `reply`, `bcc_me` and `from_owner` parameters to the `/postdraft` endpoint.
  • Added `/authenticateloginlink` endpoint.
2019-11-29 View
  • Added `/sendloginlink`, `/resendconfirmationemail` and `/unbounceuser` endpoints.
  • Added `/getsubgroupsbycategory` endpoint.
2019-11-22 View
  • Added `/getsubgroupcategories` endpoint.
2019-11-15 View
  • Changed `search_result` object to `message_search_result`.
  • Added `/searchwikis` endpoint.
  • Added `/getbounceinfo` and `/getdeliveryinfo' endpoints.
  • Added `/getmessagehistory` endpoint.
  • Added optional `type` parameter to the `getmembernotices` endpoint.
  • Added `muted` and `followed` fields to `hashtag` object.
  • Added `/getsinglefeed` endpoint.
2019-11-08 View
  • Added `/getmemberdirectory` endpoint.
  • Added `sticky_wiki_page_id` field to the `group` object.
  • Added new `id` parameter to `/getwikiset` endpoint.
  • Added new `Types` section to the docs. Currently only lists the `action` enum.
  • Added `msg_num`, `subject`, `extra`, `extra2`, `extra_id` fields to `webhook_event` objects.
  • Changed all view_* permissions to be *_visible, to be consistent.
2019-11-01 View
  • New endpoints: `newpoll`, `updatepoll`, `getpoll`, `vote`
  • New endpoint: `registeruser`
  • New endpoints: `newwikipage`, `getwikipages`, `getwikipageset`.
2019-10-18 View
  • Added `signature` to `member_info` object.
2019-10-11 View
  • Added `open_donations_visible` to `perms` object.
  • Added `subgroups_visible` to `perms` object.
  • Added `hashtags_visible` to `perms` object.
  • Removed `view_archives` from `perms` object.
  • Changed `view_guidelines` to `guidelines_visible` in `perms` object.
  • Added `perms` field to `member_info` object.
  • Added new Subs array to `user` object.
  • The `member_info` object now only returns the fields that are set by the endpoint. Previously it returned all fields, regardless of whether the fields were set or not (some endpoints won't set all the fields based on permissions).
2019-10-04 View
  • Added new `webhook_event` and `webhook_subscription` objects. Webhook endpoints will be arriving shortly.
  • BUGFIX: The `/getmembers` API endpoint would return all members, including banned and pending members, if you didn't specify a `type`, instead of only returning normal members, which it should do.
  • Added `/getphoto` endpoint.
  • Added `display_name`, `user_name`, `profile_photo_url`, `profile_privacy`, `email` fields to the `photo` object.
  • Added `/reportcontent` endpoint.
2019-09-20 View
  • Added `/newmembernotice`, `/updatemembernotice`, `/deletemembernotice`, and `/getmembernotices` endpoints.
  • Added `/searchfiles` endpoint.
  • Added `/searchphotos` endpoint.
  • Added `/getfiledirectory` and `/getfile` endpoints.
  • Changed `snippet` field to `summary` in the `search_result` object for naming consistency.
  • Added `/testnotification` endpoint.
2019-09-20 View
  • Added `sort_field`, `second_order`, `query`, `sort_dir` fields to the pagination object.
  • Added `/registerdevice` endpoint for registering device tokens for notifications.
  • Added `exclude_aliases` flag to `/gethashtags` endpoint.
  • Added `/searcharchives` endpoint and related `search_result` and `search_results_list` objects.
  • Added `profile_photo_url`, `name` and `can_view_profile` fields to the `chat` object
  • Added `alias` field to `hashtag`.
  • Added `announce` flag to `/newchat` endpoint.
  • Added `addalbum`, `updatealbum`, `deletealbum`, `addphotos`, `updatephoto`, `deletephoto` endpoints.
2019-09-13 View
  • Changed `gallery_url` to `thumbnail_url` in attachments and photos.
  • Added `getalbums` and `getphotos` endpoints.
  • Changed `profile_photo_id` field in `member_info` to `profile_photo_url`.
  • Added `chatmembers` endpoint.
  • Added `updateprofile` endpoint.
  • Added `num_drafts` field to `member_info` object.
  • Added `updateprofilephoto` and `deleteprofilephoto` endpoints.
2019-09-06 View
  • Changed `profile_photo_id` to `profile_photo_url` in the User object.
2019-08-30 View
  • Added `googleloginstart` and `googleloginfinal` endpoints.
  • Added `facebookloginstart` and `facebookloginfinal` endpoints.
  • Added the `allow_sso_login` field to User object.
  • Added new `logout` endpoint to clear cookies.
2019-08-23 View
  • BREAKING CHANGE: All POST endpoints now require a `csrf` field. The new `csrf_token` in the `login` object should be used for this.
  • BREAKING CHANGE: API endpoints have been moved to https://groups.io/api/v1. The old endpoints will remain up for a month. Please update your code as soon as possible.
  • BREAKING CHANGE: The API is moving from Basic Authentication to a cookie based authentication. The existing Basic Auth tokens will continue to work until they expire. Please update your code as soon as possible.
  • The `chatdata` endpoint is now working.
  • Added `profile_privacy` and `version` fields to `chat_message`.
  • Changed `is_subscribed` field in `chat` to `chat_sub`.
  • Changed `profile_photo_id` field in `chat_message` to `profile_photo_url`.
  • Added `show_closed` parameter to the `getchats` endpoint.
2019-08-16 View
  • Changed `/getgroup` endpoint to require a `group_name` for groups that you are not subscribed to, for security.
  • Documentation change: The Objects section has been moved to the end of the docs.
  • The Group object now includes a Perms object if you are subscribed to the group.
  • Relaxed the requirement for having the `manage_group_settings` permission when accessing the `/getgroup` endpoint.
  • Added `/sendchatmsg` endpoint.
  • Added `/getchathistory` endpoint.
  • Added `group_name` and `nice_group_name` to the Event object.
2019-08-09 View
  • Renamed all instances of `sub_id` parameters to `member_info_id`. In all cases, `sub_id` will still be accepted to maintain backwards compatibility.
  • Removed API_KEY requirement for the /login endpoint.
  • Changed the /login endpoint from GET to POST.
  • Misc documentation improvements.
2019-07-19 View
  • New Chats section and endpoints.
  • New /getevent endpoint.
  • New /rsvp endpoint.
  • New /getgroupaliases endpoint.
  • Previously, the /getsubgroups endpoint would return group objects that represented group aliases. It now longer returns these.
  • In the /directadd endpoint, if a subgroupname or subgroupid is specified that points to a group alias, the pointed to group will be used instead.
  • Misc documentation improvements.
2019-07-05 View
  • New Drafts section and endpoints.
  • Misc documentation improvements.
2019-06-21 View
  • New /getevents endpoint.
2019-06-10 View
  • Changed the format of the past member object.
2019-06-07 View
  • New /getpastmembers endpoint.
  • Various new object members.
2018-11-09 View
  • New subscription_plus field: nice_group_name.
  • New /gettopics parameter: `extended`.
2018-11-02 View
  • New subscription_plus fields: group_alias, org_id, org_domain.
  • Additional error codes for the /v1/login endpoint.
  • Working /gettopics endpoint, and start of documentation for the "topic" and "hashtag" objects.
2018-09-19 View
  • New subscription post_status values: sub_poststatus_modfirstmessage, sub_poststatus_modstartedtopics.
2018-08-29 View
  • New group field: handle_virus.
2018-08-10 View
  • Changed group field: restrict_create_hash_tags is now hash_tag_permissions.
2018-07-16 View
  • New group field: subgroup_category_id.
2018-07-10 View
  • New group fields: allow_reposts, min_days_between_reposts, max_number_of_reposts.
2018-06-21 View
  • Changed user field: time_pref now refers to how times should be formatted.
  • New user field: date_pref.
  • New group fields: default_date_pref, default_time_pref.
2018-06-12 View
  • New group fields: seperate_footers, allow_downloads.
  • New permissions fields: download_archives, download_entire_group
2018-02-26 View
  • The /updatemember endpoint has been updated with the ability to set a member's signature and email address (if a premium group).
  • Added group_attachments_moderated as an option for a group's handle_attachments field.
  • Added group_id to the errors section of the direct_add object.
  • Added subscription permission `sub_perm_viewmembers`.
  • Added `lock_group` option to the /updategroup endpoint.
2018-02-02 View
  • The group object now includes the new `fig_leaf` attribute.
2018-01-11 View
  • The group object now returns various counts, including subs, pending subs, pending messages, threads and messages.
  • The group object now returns the new default timezone value.
2017-10-23 View
  • Working /creategroup endpoint.
  • Changed the "invalid groupname" error from /createsubgroup to "invalid group_name" for consistency.
  • /createsubgroup now takes subscription options.
2017-10-06 View
  • Working /bulkremovemembers endpoint.
  • /getgroup can now take a group_name parameter instead of a group_id parameter.
2017-09-01 View
  • Working /downloadarchives endpoint.
2017-08-24 View
  • Working /updatesub endpoint.
  • Working /deletesub endpoint.
  • Improvements in doc consistency.
2017-08-21 View
  • Working /deletegroup endpoint.
2017-08-18 View
  • Pointer to this new changelog.
  • Working /createsubgroup endpoint.
2017-08-17 View