usergroups list

GET {{baseUrl}}/usergroups.list?include_users=<boolean>&include_count=<boolean>&include_disabled=<boolean>

List all User Groups for a team

Request Params

KeyDatatypeRequiredDescription
include_usersstringInclude the list of users for each User Group.
include_countstringInclude the number of users in each User Group.
include_disabledstringInclude disabled User Groups.

RESPONSES

status: OK

{&quot;ok&quot;:&quot;\u003cboolean\u003e&quot;,&quot;usergroups&quot;:[{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;team_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_usergroup&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_subteam&quot;:&quot;\u003cboolean\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;handle&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_external&quot;:&quot;\u003cboolean\u003e&quot;,&quot;date_create&quot;:&quot;\u003cinteger\u003e&quot;,&quot;date_update&quot;:&quot;\u003cinteger\u003e&quot;,&quot;date_delete&quot;:&quot;\u003cinteger\u003e&quot;,&quot;auto_type&quot;:{},&quot;auto_provision&quot;:&quot;\u003cboolean\u003e&quot;,&quot;enterprise_subteam_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_by&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_by&quot;:&quot;\u003cstring\u003e&quot;,&quot;deleted_by&quot;:{},&quot;prefs&quot;:{&quot;channels&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;groups&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},&quot;channel_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;user_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;team_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_usergroup&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_subteam&quot;:&quot;\u003cboolean\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;handle&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_external&quot;:&quot;\u003cboolean\u003e&quot;,&quot;date_create&quot;:&quot;\u003cinteger\u003e&quot;,&quot;date_update&quot;:&quot;\u003cinteger\u003e&quot;,&quot;date_delete&quot;:&quot;\u003cinteger\u003e&quot;,&quot;auto_type&quot;:{},&quot;auto_provision&quot;:&quot;\u003cboolean\u003e&quot;,&quot;enterprise_subteam_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_by&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_by&quot;:&quot;\u003cstring\u003e&quot;,&quot;deleted_by&quot;:{},&quot;prefs&quot;:{&quot;channels&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;groups&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},&quot;channel_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;user_count&quot;:&quot;\u003cinteger\u003e&quot;,&quot;users&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]}]}