Below are the various requests that can be performed against the
Experience Group resource, as well as the expected
parameters and the potential responses.
A valid api access token is required to access this endpoint. The token must
include at least one of the following scopes:
all.Application, all.Organization, all.User, experienceGroup.*, or experienceGroup.delete.
Request Path Components
Path Component
Description
Example
APPLICATION_ID
ID associated with the application
575ec8687ae143cd83dc4a97
EXPERIENCEGROUPID
ID associated with the experience group
575ed78e7ae143cd83dc4aab
Request Headers
Name
Required
Description
Default
Authorization
Y
The token for authenticating the request, prepended with Bearer
GET https://api.app.wnology.io/applications/APPLICATION_ID/experience/groups/EXPERIENCE_GROUP_ID
Authentication
A valid api access token is required to access this endpoint. The token must
include at least one of the following scopes:
all.Application, all.Application.read, all.Organization, all.Organization.read, all.User, all.User.read, experienceGroup.*, or experienceGroup.get.
Request Path Components
Path Component
Description
Example
APPLICATION_ID
ID associated with the application
575ec8687ae143cd83dc4a97
EXPERIENCEGROUPID
ID associated with the experience group
575ed78e7ae143cd83dc4aab
Request Query Parameters
Name
Required
Description
Default
Example
includeDirectDeviceCount
N
Whether or not to return count of devices associated directly with this group
false
includeDirectDeviceCount=true
includeTotalDeviceCount
N
Whether or not to return count of devices associated with this group or any of its descendents
false
includeTotalDeviceCount=true
Request Headers
Name
Required
Description
Default
Authorization
Y
The token for authenticating the request, prepended with Bearer
A valid api access token is required to access this endpoint. The token must
include at least one of the following scopes:
all.Application, all.Organization, all.User, experienceGroup.*, or experienceGroup.patch.
Request Path Components
Path Component
Description
Example
APPLICATION_ID
ID associated with the application
575ec8687ae143cd83dc4a97
EXPERIENCEGROUPID
ID associated with the experience group
575ed78e7ae143cd83dc4aab
Request Headers
Name
Required
Description
Default
Authorization
Y
The token for authenticating the request, prepended with Bearer
Request Body
The body of the request should be serialized JSON that validates against
the Experience Group Patch schema. For example, the following would be a
valid body for this request:
{"name":"My New Group Name","experienceUserIds":["575ed70c7ae143cd83dc4aa9","675ed70c7ae143cd83dc4aa9"],"experienceEndpointIds":["58b9d743cbfafe1be675744b","58b9d743cbfafe1be675744c"],"parentId":"775ed70c7ae143cd83dc4aa9","deviceIds":["58b9d743cbfafe1be675744d"],"deviceTags":[{"key":"myKey","value":"foo"}]}
Curl Example
curl -H 'Content-Type: application/json'\
-H 'Accept: application/json'\
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN'\
-X PATCH \
-d '{"name":"My New Group Name","experienceUserIds":["575ed70c7ae143cd83dc4aa9","675ed70c7ae143cd83dc4aa9"],"experienceEndpointIds":["58b9d743cbfafe1be675744b","58b9d743cbfafe1be675744c"],"parentId":"775ed70c7ae143cd83dc4aa9","deviceIds":["58b9d743cbfafe1be675744d"],"deviceTags":[{"key":"myKey","value":"foo"}]}'\
https://api.app.wnology.io/applications/APPLICATION_ID/experience/groups/EXPERIENCE_GROUP_ID