JUjumpcloud
System Groups

View an individual System Group details

This endpoint returns the details of a System Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{Group_ID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
get/systemgroups/{id}

Request

Headers

x-org-idstring

Organization identifier that can be obtained from console settings.

Response

OK

attributesGraphAttributes nullable

The graph attributes.

descriptionstring

Description of a System Group

emailstring

E-mail address associated with a System Group

idstring

ObjectId uniquely identifying a System Group.

memberQueryErrorFlagsstring[]

Group error flags indicating errors encountered during member query evaluation.

Possible flag values:

  • CYCLE: A cyclic dependency was detected in group membership
  • INVALID_GROUP_REFERENCE: The group reference is invalid or does not exist

The member_query_error_flags as a field supports array-based filtering:

  • CO: Contains Overlap - check if array overlaps with the specified array (use ["VALUE"] for single value)
  • NCO: Not Contains Overlap - check if array does not overlap
  • EQ: Exact array match
  • NE: Not equal to array
  • IN: Array contains any of the specified values Note: Single value is converted to array `["value"]``.
membershipMethod'NOTSET' | 'STATIC' | 'DYNAMIC_REVIEW_REQUIRED' | 'DYNAMIC_AUTOMATED'

The type of membership method for this group. Valid values include NOTSET, STATIC, DYNAMIC_REVIEW_REQUIRED, and DYNAMIC_AUTOMATED.

Note DYNAMIC_AUTOMATED and DYNAMIC_REVIEW_REQUIRED group rules will supersede any group enrollment for group-associated MDM-enrolled devices.

Use caution when creating dynamic device groups with MDM-enrolled devices to avoid creating conflicting rule sets.

memberSuggestionsNotifyboolean

True if notification emails are to be sent for membership suggestions.

namestring

Display name of a System Group.

organizationObjectIdstring nullable

id of the organization owning this group

type'system_group'

The type of the group; always 'system' for a System Group.

Changes

No recorded changes to this operation across all 1 revision of this API.