Group Users Collection
API methods to work with Group Users
Group User is an association between a Group and a User, represents who can manage a group and all properties under the group with which role and access rights.
Group Users List
Retrieve list of Group Users associated with a Group.
Request:
GET https://staging.channex.io/api/v1/group_users?filter[group_id]=GROUP_ID
Returns
Success
Method can return a Success result with 200 OK
HTTP Code if operation is successful. Will contain a list of Group User objects in the answer.
Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized
HTTP Code if wrong Bearer Token provided.
Invite User to Group
Create a new Group User. By inviting a User into a Group, you are automatically granting access for this user to all properties in the Group.
Request:
POST https://staging.channex.io/api/v1/group_users
Query body (JSON):
{
"invite": {
"group_id": "52397a6e-c330-44f4-a293-47042d3a3607",
"user_email": "[email protected]",
"role": "user",
"overrides": {}
}
}
Fields
group_id [required]
String with valid UUID for Group object what you would use as target for invitation.
user_email [required]
String with a valid email address of invited user. Note: If user is not registered at our system, we are create they account automatically and send email with instructions to on-board into channex.io.
role [required]
String with a valid role name.
Right now you can use 2 roles - owner
and user
.
overrides [optional]
JSON Object with access policies overrides.
Returns
Success
Method can return a Success result with 201 Created
HTTP Code if operation is successful. Will contain a Group User object in the answer.
Bad Request Error
Method can return a Bad Request Error result with 400 Bad Request
HTTP Code if provided user already invited.
Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized
HTTP Code if wrong Bearer Token provided.
Forbidden Error
Method can return a Forbidden Error result with 403 Forbidden
HTTP Code if current user not have permissions to invite user into provided property.
Validation Error
Method can return a Validation Error result with 422 Unprocessable Entity
HTTP Code if any validation rule is failed.
Get Group User by ID
Retrieve a Group User by ID.
Request:
GET https://staging.channex.io/api/v1/group_users/:id
Returns
Success
Method can return a Success result with 200 OK
HTTP Code if operation is successful. Will contain a Group User object in the answer.
Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized
HTTP Code if wrong Bearer Token provided.
Forbidden Error
Method can return a Forbidden Error result with 403 Forbidden
HTTP Code if current user not have permissions to call this action.
Update Group User
Update the Group User information.
Request:
PUT https://staging.channex.io/api/v1/group_users/:id
Query body (JSON):
{
"group_user": {
"role": "user",
"overrides": null
}
}
Fields
Through this method you can update only two fields - role and overrides. Please see Invite User to Group for more detailed information.
Returns
Success
Method can return a Success result with 200 OK
HTTP Code if operation is successful. Will contain a Group User object in the answer.
Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized
HTTP Code if wrong Bearer Token provided.
Forbidden Error
Method can return a Forbidden Error result with 403 Forbidden
HTTP Code if current user not have permissions to call this action.
Resource Not Found Error
Method can return a Resource Not Found Error result with 404 Not Found
HTTP Code if requested Group User is not defined.
Validation Error
Method can return a Validation Error result with 422 Unprocessable Entity
HTTP Code if any validation rule is failed.
Withdraw Group User Access
Revoke Group User access to a specific Group.
Request:
DELETE https://staging.channex.io/api/v1/group_users/:id
Returns
Success
Method can return a Success result with 200 OK
HTTP Code if operation is successful.
Bad Request Error
Method can return a Bad Request Error result with 400 Bad Request
HTTP Code if user will try to remove them self.
Unauthorised Error
Method can return a Unauthorised Error result with 401 Unauthorized
HTTP Code if wrong Bearer Token provided.
Forbidden Error
Method can return a Forbidden Error result with 403 Forbidden
HTTP Code if current user not have permissions to call this action.
Resource Not Found Error
Method can return a Resource Not Found Error result with 404 Not Found
HTTP Code if requested Group User is not defined.
Last updated
Was this helpful?