Groups API

Use the Groups API to add, edit, list, and delete groups in EASE. Groups are the connection between individual users and applications. In order for a user to have access to an application in the App Catalog, the user must be a member of the group to which the application belongs.

You can create groups to organize user access to applications. For example, you may want to create groups for different functional areas within your organization since employees in each of those areas will have different application needs.

The system has one default group called “All Users.” You cannot delete or change the name of the All Users group.

The Groups API lets you:

  • List all groups
  • Add, update, or delete a group
  • Add one user to multiple groups
  • Add multiple users to one group
  • Remove one or more users from a group
  • List all applications in a group
  • List all groups associated with a specific application
  • Add to and delete applications from a group
  • Specify that an application is mandatory for a group

Resources

DELETE /v1/groups/(group_psk)

Delete Group

Requires administrator privileges. Authenticate as an EASE administrator.

Permanently deletes a group from the authenticated user’s organization. Before deleting a group, consider the impact it will have on members of that group. They will no longer be able to access applications they were authorized to use based on membership to that group.

You cannot delete the “All Users” group; it is the system’s default group.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/<group_psk>
Europe https://eu01ws.apperian.eu/v1/groups/<group_psk>

URL Parameters

group_psk
(Required) Unique ID assigned by EASE to the group. DATA TYPE: integer

Header Parameters

X-TOKEN
(Required) Session token returned by POST /users/authenticate.

Data Parameters

None

Example Request

The following example deletes group 123.

curl -X DELETE https://na01ws.apperian.com/v1/groups/123 --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
  "deleted_group": {
    "psk": 123,
    "name": "Green Team",
    "description": "Office Green Team Project"
  }
}
DELETE /v1/groups/(group_psk)/applications/

Delete Applications from Group

Requires administrator privileges. Authenticate as an EASE administrator.

Removes a comma-separated list of applications from a group. Specify apps by app_psk.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/<group_psk>/applications/
Europe https://eu01ws.apperian.eu/v1/groups/<group_psk>/applications/

URL Parameters

group_psk
(Required) Unique ID assigned by EASE to the group. DATA TYPE: integer

Header Parameters

X-TOKEN
(Required) Session token returned by POST /users/authenticate.
Content-Type
(Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

app_psk
(Required) Comma-separated list of the app_psks for the applications you want to remove from the group.

Example Request

The following example removes apps 14203, 5714, 14205 from group 576.

curl -X DELETE https://na01ws.apperian.com/v1/groups/576/applications/
      --header "Content-Type: application/json"
      --header "X-TOKEN: hShU5OD-SiadD8gyC_K4HA"
      --data '{"app_psk": [14203, 5714, 14205]}'

Example Response

{
  "apps_removed": [
    14203,
    5714,
    14205
   ],
   "apps_failed": []
}
DELETE /v1/groups/(group_psk)/users/

Remove Users from Group

Requires administrator privileges. Authenticate as an EASE administrator.

Removes a comma-separated list of users from a group. Specify users by user_psk.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/<group_psk>/users/
Europe https://eu01ws.apperian.eu/v1/groups/<group_psk>/users/

URL Parameters

group_psk
(Required) Unique ID assigned by EASE to the group. DATA TYPE: integer

Header Parameters

X-TOKEN
(Required) Session token returned by POST /users/authenticate.
Content-Type
(Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

user_psk
(Required) Comma-separated list of the user_psks for the users you want to remove from the group.

Example Request

The following example removes user 21778 from group 3635. The command also attempts to remove user 103172, but that user is not in group 3635.

curl -X DELETE https://na01ws.apperian.com/v1/groups/3635/users/
--header "Content-Type: application/json"
--header "X-TOKEN: hShU5OD-SiadD8gyC_K4HA"
--data '{"user_psk": [103172, 26886]}'

Example Response

{
  "users_failed": [
    {
      "object_id": 103172,
      "error": {
         "code": 20,
         "message": "User 103172 is not in the group 3635",
         "guid": "2bbcb3f0-7fe4-4aac-ac09-1673e578a8de",
         "error_details": null
       }
     }
   ],
   "users_removed": [
     21778
   ]
 }
GET /v1/groups/

List All Groups

Requires administrator privileges. Authenticate as an EASE administrator.

Returns a list of all the groups for the authenticated user’s organization. This list includes the number of users and number of applications belonging to each group.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/
Europe https://eu01ws.apperian.eu/v1/groups/

URL Parameters

When you send a GET request to this resource, you can specify URL parameters to search, sort, and paginate the JSON data returned in the response. For more information, see Controlling GET Responses.

Header Parameter

X-TOKEN
(Required) Session token returned by POST /users/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v1/groups/ --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
  "groups": [
     {
       "app_count": 74,
       "psk": 3071,
       "user_count": 36,
       "name": "All Users",
       "description": "All Users in system (default group)"
     },
     {
       "app_count": 1,
       "psk": 3634,
       "user_count": 6,
       "name": "Boston",
       "description": "Boston Employees"
     },
     {
       "app_count": 0,
       "psk": 3635,
       "user_count": 5,
       "name": "Engineering",
       "description": "Engineering Team"
     },
     {
       "app_count": 6,
       "psk": 5326,
       "user_count": 3,
       "name": "Customer Support",
       "description": "Worldwide Customer Support Organization"
     },
     {
       "app_count": 0,
       "psk": 5775,
       "user_count": 1,
       "name": "QA Workflow",
       "description": "Quality assurance engineering"
     },
     {
       "app_count": 0,
       "psk": 6255,
       "user_count": 4,
       "name": "Valladolid",
       "description": "Valladolid Office"
     },
     {
       "app_count": 0,
       "psk": 6413,
       "user_count": 3,
       "name": "Paris Sales",
       "description": "Paris Sales Office"
     }
    ]
  }
GET /v1/groups/(group_psk)/applications/

List Applications in Group

Requires administrator privileges. Authenticate as an EASE administrator.

Returns a list of the applications that are in the specified group.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/<group_psk>/applications/
Europe https://eu01ws.apperian.eu/v1/groups/<group_psk>/applications/

URL Parameters

group_psk
(Required) Unique ID assigned by EASE to the group. DATA TYPE: integer

Header Parameter

X-TOKEN
(Required) Session token returned by POST /users/authenticate.

Data Parameters

None

Example Request

This example lists appliations in the group with the 123 group_psk.

curl -X GET https://na01ws.apperian.com/v1/groups/123/applications/ --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

There is one application in the group.

{
   "applications": [
     {
       "display_message": "",
       "operating_system": 1,
       "update_compliance_period_in_days": null,
       "icon_path_114": "",
       "url_scheme": "",
       "form_factor": 3,
       "long_description": "An Awesome App",
       "allow_ota": true,
       "is_adhoc": false,
       "platform": null,
       "is_hybrid": false,
       "required_by": "3099-12-31T00:00:00+00:00",
       "is_pairing_webapp": false,
       "os_version": null,
       "is_app_catalog": false,
       "reviews_enabled": null,
       "short_description": "An Awesome App",
       "screenshot_path3": "",
       "screenshot_path1": "",
       "type": 0,
       "screenshot_path4": "",
       "screenshot_path5": "",
       "status": 1,
       "psk": 14080,
       "icon_path_512": "",
       "sort_weight": 1000,
       "no_auth_delivery_enabled": false,
       "deleted": null,
       "icon_path": "org_1062/iphone_14080/icon_0ed5a151fbf5277494feff800d5a88c5.png",
       "is_email_config_profile": false,
       "custom_metadata": null,
       "add_to_start": false,
       "screenshot_path2": "",
       "tablet_screenshot_path5": "",
       "min_os_version": "3.1",
       "bundle_id": "com.apperian.app",
       "banner_image_url": null,
       "tablet_screenshot_path3": "",
       "icon_path_72": "",
       "tablet_screenshot_path4": "",
       "bundle_version": null,
       "tablet_screenshot_path2": "",
       "name": "App",
       "tablet_screenshot_path1": "",
       "upgrade_bundle_id": null,
       "required": false,
       "push_enabled": false,
       "is_background_daemon": false,
       "is_critical": false,
       "mandatory": true,
       "latest": false,
       "versions": [
         {
           "psk": 214,
           "posted_date": "2016-02-15T15:38:30+00:00",
           "description": "uu",
           "version_num": "0.1.656.958057",
           "verification_status": 0,
           "latest_install_file": 200,
           "release_date": "2016-02-15T15:38:30+00:00",
           "required": false,
           "mdm_id": null,
           "required_by": "9999-12-31T23:59:59.999999",
           "version": "0.1.656.958057",
           "mdm_status": 0,
           "app_psk": 95,
           "wrap_status": 0,
           "signstatus": 1,
           "veracode_verification_status": 0,
           "kryptowire_verification_status": 0,
           "notify_users": true
         }
       ]
       "is_critical": false
     }
   ]
}
GET /v1/groups/(group_psk)/users/

List Users in Group

Requires administrator privileges. Authenticate as an EASE administrator.

Returns a list of users in a specified group.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/<group_psk>/users/
Europe https://eu01ws.apperian.eu/v1/groups/<group_psk>/users/

URL Parameters

group_psk
(Required) Unique ID assigned by EASE to the group. DATA TYPE: integer

Header Parameter

X-TOKEN
(Required) Session token returned by POST /users/authenticate.

Data Parameters

None

Example Request

curl -X GET https://na01ws.apperian.com/v1/groups/123/users/ --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

{
   "users_in_group": [
     {
       "psk": 21778,
       "first_name": "Alexander",
       "last_name": "Christopher",
       "deleted": null,
       "email": "achristopher@example.com",
       "mobile_phone": "978-448-8637",
       "role": 1,
       "created_date": "2012-05-02T19:36:02+00:00",
       "until_date": "9999-12-31T23:59:59.999999",
       "disabled_reason": null,
       "id": "achristopher@example.com",
       "last_login_from_catalog": null
     },
     {
       "psk": 21781,
       "first_name": "Melanie",
       "last_name": "Boatwright",
       "deleted": null,
       "email": "mboatwright@example.com",
       "mobile_phone": "978-448-8637",
       "role": 1,
       "created_date": "2012-05-02T19:36:02+00:00",
       "until_date": "2013-11-18T14:38:26+00:00",
       "disabled_reason": 0,
       "id": "mboatwright@example.com",
       "last_login_from_catalog": null
      }
    ]
  }
POST /v1/groups/

Add Group

Requires administrator privileges. Authenticate as an EASE administrator.

Adds a new group to the authenticated user’s organization. When you create a new group, you are required to provide a group name and description. Optionally, you can also add users and assign applications to the group. When you assign an application, you can specify whether it is mandatory for the group. When an application is mandatory, users are forced to install the latest version of the app that is available to them before they can use the App Catalog.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/
Europe https://eu01ws.apperian.eu/v1/groups/

URL Parameters

None

Header Parameter

X-TOKEN
(Required) Session token returned by POST /users/authenticate.
Content-Type
(Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

name
(Required) Name for the group. Maximum characters: 128
description
(Required) Description for the group that will appear in the list of groups on the Groups page in the EASE Portal. Maximum characters: 500
users

(Optional) Include the following array:

  • add_users lists the user_psks for users that you want to add to the group.

For example:

"users": {"add_users": [123, 345, 789]}
apps

(Optional) An array of objects describing this group’s relationships with applications.

Each object must contain the following parameters:

  • id: The identifier (app_psk) for the app to add or remove.

  • versions: The ID of a specific version to assign to the group. If you want the group to have access to

    the latest version of the app (even if new versions are uploaded), then set is_latest to true and send an empty array with this attribute.

  • is_mandatory: A boolean that specifies that the app is mandatory for users in the group.

  • is_latest: A boolean specifies that the latest version of the app will always be assigned to the group.

    When set to true, send an empty array with the versions parameter.

  • is_assigned: A boolean specifies whether the app is assigned to the group.

    To assign an app to the group, set to true.

For example:

"apps": [
    { "is_assigned": true, "id": 77, "versions": [], "is_mandatory": true, "is_latest": true },
    { "is_assigned": true, "id": 85, "versions": [124], "is_mandatory": false, "is_latest": false }
 ]

Example Request

This request creates a grouped named Paris and adds three users to the group. It also assigns two applications to the group. With one app, the latest version is assigned; with the other app, a specific version is assigned.

curl -X POST https://na01ws.apperian.com/v1/groups/ --header "Content-Type: application/json" --header "X-TOKEN: nF7ByByxRlyDd59qMkCLZA" --data '{"name": "Paris", "description": "Paris Office", "users": { "add_users": [404975, 404969, 404964]}, "apps": [ { "is_assigned": true, "id": 58643, "versions": [], "is_mandatory": true, "is_latest": true }, { "is_assigned": true, "id": 61043, "versions": [184295], "is_mandatory": false, "is_latest": false }]}'

Example Response

This is an example of a successful response returned regardless of whether the request included the optional users and apps parameters.

{
  "group": {
    "psk": 9859,
    "name": "Paris",
    "description": "Paris Office"
 }
}

Backward Compatibility

The following data parameters are still supported for backward compatibility with older API integrations. If you are doing any new development that interfaces with this resource, use the parameters listed above.

group_name
The same as name above.
group_description
The same as description above.
users

(Optional) Include an included_users array listing the user_psks for any users that you want to add to the new group. For example:

"users": {"included_users": [123, 345, 789]}
apps

(Optional) Include the included_apps array listing the app_psks for any users that you want to add to the new group. For example:

"apps": {"included_apps": [8987, 6547, 2765]}

Example Request

This request creates a grouped named Paris, but does not populate it with any users or assign any applications to it.

curl -X POST https://na01ws.apperian.com/v1/groups/ --header "Content-Type: application/json"
--header "X-TOKEN: hShU5OD-SiadD8gyC_K4HA"
--data '{"group_name": "Paris", "group_description": "Paris Office"}'

This request creates a grouped named Boston that is populated with three users and has three applications assigned to it.

curl -X POST https://na01ws.apperian.com/v1/groups/ --header "Content-Type: application/json"
--header "X-TOKEN: hShU5OD-SiadD8gyC_K4HA"
--data '{"group_name": "Boston", "group_description": "Boston Office",
         "users": {"add_users": [118985, 118951, 118950]},
         "apps": [{ "is_assigned": true, "id": 77, "versions": [], "is_mandatory": true, "is_latest": true }]}'

Example Response

This is an example of a successful response returned regardless of whether the request included the optional users and apps parameters.

{
  "group": {
    "psk": 6413,
    "name": "Paris",
    "description": "Paris Office"
  }
}
POST /v1/groups/(group_psk)/applications/

Add Applications to Group

Requires administrator privileges. Authenticate as an EASE administrator.

Adds a comma-separated list of applications to a specified group. Specify apps by app_psk.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/<group_psk>/applications/
Europe https://eu01ws.apperian.eu/v1groups/<group_psk>/applications/

URL Parameters

group_psk
(Required) Unique ID assigned by EASE to the group. DATA TYPE: integer

Header Parameter

X-TOKEN
(Required) Session token returned by POST /users/authenticate.
Content-Type
(Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

app_psk
(Required) Comma-separated list of the app_psks for the applications you want to add to the group.

Example Request

The following example adds apps 14203, 5714, and 14205 to group 123.

curl -X POST https://na01ws.apperian.com/v1/groups/123/applications/
--header "Content-Type: application/json"
--header "X-TOKEN: hShU5OD-SiadD8gyC_K4HA"
--data '{"app_psk": [14203, 5714, 14205]}'

Example Response

{
  "apps_added": [
    14203,
    5714,
    14205
  ],
  "apps_failed": []
}
POST /v1/groups/(group_psk)/users/

Add Multiple Users to Group

Requires administrator privileges. Authenticate as an EASE administrator.

Adds a list of users to a specified group. Specify users by user_psk.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/<group_psk>/users/
Europe https://eu01ws.apperian.eu/v1/groups/<group_psk>/users/

URL Parameters

group_psk
(Required) Unique ID assigned by EASE to the group. DATA TYPE: integer

Header Parameter

X-TOKEN
(Required) Session token returned by POST /users/authenticate.
Content-Type
(Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

user_psk
(Required) Comma-separated list of the user_psks for the users you want to add to the group.

Example Request

The following example adds users with user_psks 103172, 26886, and 21778 to group 123.

curl -X POST https://na01ws.apperian.com/v1/groups/123/users/ --header "Content-Type: application/json"
     --header "X-TOKEN: hShU5OD-SiadD8gyC_K4HA" --data '{"user_psk": [103172, 26886, 21778]}'

Example Response

{
  "users_failed": [],
  "users_added": [
    103172,
    26886,
    21778
  ]
}
POST /v1/groups/users/(user_psk)

Add One User to Multiple Groups

Requires administrator privileges. Authenticate as an EASE administrator.

Adds a specified user to a list of groups. Specify groups by group_psk.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/users/<user_psk>
Europe https://eu01ws.apperian.eu/v1/groups/users/<user_psk>

URL Parameters

user_psk
(Required) Unique ID assigned by EASE to the user you want to add to the list of groups. DATA TYPE: integer

Header Parameter

X-TOKEN
(Required) Session token returned by POST /users/authenticate.
Content-Type
(Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

group_psk
(Required) Comma-separated list of the group_psks for the groups to which you want to add the user.

Example Request

The following example adds user 21778 to groups 3635, 5775, and 6178.

curl -X POST https://na01ws.apperian.com/v1/groups/users/21778 --header "Content-Type: application/json"
     --header "X-TOKEN: hShU5OD-SiadD8gyC_K4HA" --data '{"group_psk": [3635, 5775, 6178]}'

Example Response

{
  "added_groups": [
    3635,
    5775,
    6178
  ],
  "failed_groups": []
}
PUT /v1/groups/(group_psk)

Update Group

Requires administrator privileges. Authenticate as an EASE administrator.

Updates data for an existing group in the authenticated user’s organization. You can update any of the following data parameters:

  • Group name
  • Group description
  • Users in the group (add and/or remove users)
  • Applications assigned to the group (add and/or remove applications)

When you assign an application, you can specify whether it is mandatory for the group. When an application is mandatory, users are forced to install the latest version of the app that is available to them before they can use the App Catalog.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/<group_psk>
Europe https://eu01ws.apperian.eu/v1/groups/<group_psk>

URL Parameters

group_psk
(Required) Unique ID assigned by EASE to the group. DATA TYPE: integer

Header Parameter

X-TOKEN
(Required) Session token returned by POST /users/authenticate.
Content-Type
(Required) Specifies the content type of the body of data sent with the request. Set to: application/json

Data Parameters

name
(Optional) Updated name for the group. Maximum characters: 128
description
(Optional) Updated description for the group. Maximum characters: 500
users

(Optional) Include one or both of the following arrays:

  • add_users lists the user_psks for users that you want to add to the group.
  • remove_users lists the user_psks for users that you want to remove from the group.

For example:

"users": {"add_users": [123, 345, 789],"remove_users": [123, 345, 789]}
apps

(Optional) An array of objects describing changes to this group’s relationship with the included applications.

Each object must contain the following parameters:

  • id: The identifier (app_psk) for the app to add or remove.
  • versions: The ID of a specific version to assign to the group. If you want the group to have access to the latest version of the app (even if new versions are uploaded), then set is_latest to true and send an empty array with this attribute.
  • is_mandatory: A boolean that specifies that the app is mandatory for users in the group.
  • is_latest: A boolean that specifies that the latest version of the app will always be assigned to the group. When set to true, send an empty array with the versions parameter.
  • is_assigned: A boolean specifying whether the app is assigned to the group. To unassign an app already in the group, set to false. To assign a new app to the group, set to true.

For example:

The following example adds an app to the group and removes an app from the group.

"apps": [
    { "is_assigned": true, "id": 77, "versions": [], "is_mandatory": true, "is_latest": true },
    { "is_assigned": false, "id": 85, "versions": [124], "is_mandatory": false, "is_latest": false }
 ]

Example Request

This request edits the Paris group to remove one user and add one user. It also unassigns one application from the group, and assigns the latest version of another application.

curl -X PUT https://na01ws.apperian.com/v1/groups/9859 --header "Content-Type: application/json" --header "X-TOKEN: I3qt5YrvTXKvvIWXPqkIrQ" --data '{"users": { "add_users": [404947], "remove_users": [404975]}, "apps": [ { "is_assigned": false, "id": 58643, "versions": [], "is_mandatory": true, "is_latest": true }, { "is_assigned": true, "id": 61576, "versions": [], "is_mandatory": false, "is_latest": true }]}'

Example Response

This is an example of a successful response returned regardless of whether the request included the optional users and apps parameters.

{
  "group": {
    "psk": 9859,
    "name": "Paris",
    "description": "Paris Office"
 }
}

Backward Compatibility

The following data parameters are still supported for backward compatibility with older API integrations. If you are doing any new development that interfaces with this resource, use the parameters listed above.

group_name
The same as name above.
group_description
The same as description above.
users

(Optional) Include one or both of the following arrays:

  • included_users list of the the user_psks for any users that you want to add to the group.
  • removed_users list of the user_psks for any users that you want to remove from the group.

For example:

"users": {"included_users": [123, 345, 789],"removed_users": [123, 345, 789]}
apps

(Optional) Include one or both of the following arrays:

  • included_apps lists the app_psks for any apps that you want to add to the group.
  • removed_apps lists the app_psks for any apps that you want to remove from the group.

For example:

"apps": {"included_apps": [8987, 6547, 2765],"removed_apps": [8764,998,432]}

Example Request

This request changes the name of a group from Paris to Paris Sales. It also changes the description of the group. It does not modify the group’s user membership or applications.

curl -X PUT https://na01ws.apperian.com/v1/groups/6413 --header "Content-Type: application/json"
--header "X-TOKEN: hShU5OD-SiadD8gyC_K4HA"
--data '{"group_name": "Paris Sales", "group_description": "Paris Sales Office"}'

This request updates the group to add and remove both users and groups.

curl -X PUT https://na01ws.apperian.com/v1/groups/6413 --header "Content-Type: application/json"
--header "X-TOKEN: iLrSdf8yTu2LPui9mzMVog"
--data '{"group_name": "Boston", "group_description": "Boston Office",
         "users": {"included_users": [118949], "removed_users": [118985]},
         "apps": [{ "is_assigned": false, "id": 77, "versions": [], "is_mandatory": true, "is_latest": true },
                  { "is_assigned": false, "id": 85, "versions": [12], "is_mandatory": false, "is_latest": false}]
         }'

Example Response

{
  "group": {
     "psk": 6413,
     "name": "Paris Sales",
     "description": "Paris Sales Office"
  }
}
GET /v1/groups/applications/(app_psk)/

Requires user context. Use session token returned from POST /users/authenticate.

Returns the list of groups associated with the application.

URLs

Environment URL
North America https://na01ws.apperian.com/v1/groups/applications/<app_psk>/
Europe https://eu01ws.apperian.eu/v1/groups/applications/<app_psk)/

URL Parameters

app_psk
(Required) Unique ID assigned by EASE to the application. DATA TYPE: integer

Header Parameter

X-TOKEN
(Required) Session token returned by POST /users/authenticate.

Example Request

curl -X GET https://na01ws.apperian.com/v1/groups/applications/75/ --header "X-TOKEN: eTg8ktZXRqKIBJTHunwP6A"

Example Response

In the following example response, the application is assigned to two groups, the All Users group and the Sales group. The All Users group will always see the latest (most recent) version of this app, while the Sales group is specifically assigned to version 3.0 of this app. This app is mandatory for the Sales group.

{
  "groups": [
    {
      "psk": 135,
      "is_latest_assigned": true,
      "mandatory": false,
      "name": "All Users",
      "versions": [],
      "description": "All Users in system (default group)"
    },
    {
      "psk": 143,
      "is_latest_assigned": false,
      "mandatory": true,
      "name": "Sales",
      "versions": [
        {
          "psk": 114,
          "wrap_status": 1,
          "description": "Production Release v3",
          "version_num": "3.0",
          "sign_status": 1
        }
      ],
      "description": "Sales Tools"
    }
  ]
}