Manage Group Templates and Policies
EasyLife 365 Collaboration API enables the management of Microsoft 365 Group (including Teams) templates and policies.
Permissions
| Permission Type | Permissions (Scope) |
|---|---|
| Delegated (work or school account) | https://api.insiders.easylife365.cloud/admin/Config.ReadWrite.All |
| Application | Not supported. |
HTTP Request
PATCH https://api.insiders.easylife365.cloud/admin/collab/v1/manage/groups/{group-id}/
Content-Type: application/json
HTTP Request Headers
| Header | Value |
|---|---|
| Authorization | Bearer token. (Required) |
| Content-Type | application/json |
Request Body
| Property | Type | Description |
|---|---|---|
templateId | String | ID of the Guest Template (Optional) |
policyId | String | ID of the Guest Policy (Optional) |
Consider the following basic rules
- all values are optional. If you do not specify and value, no change will be applied
- if you want to assign a template and the policy, you need to specify both values explicitly
- if you want to clear a value (e.g. removing a policy), then pass as a value
"00000000-0000-0000-0000-000000000000"
Rules
- All fields are optional. If a value is not specified, no changes will be made.
- To assign both a template and policy, you must explicitly specify both values.
- To clear a field (e.g., removing a policy), use
"00000000-0000-0000-0000-000000000000"as the value.
Response
A successful request returns the updated Microsoft Group information.
Example 1: Assign a template and a policy to the Microsoft 365 Group
This example assigns a template and policy to the Microsoft 365 Group with ID 57523d68-2913-4fc0-8f91-af100f37562f.
PATCH https://api.insiders.easylife365.cloud/admin/collab/v1/manage/groups/57523d68-2913-4fc0-8f91-af100f37562f/
Content-Type: application/json
{
"templateId": "3b20926e-8ff5-4d8a-b0c6-ddd765df6821",
"policyId": "ad869549-d693-4d20-8879-402d5ed3d991"
}
Example 2: Clear the policy for a Microsoft 365 Group
This example clears the policy for the Microsoft Group with ID 57523d68-2913-4fc0-8f91-af100f37562f.
PATCH https://api.insiders.easylife365.cloud/admin/collab/v1/manage/groups/57523d68-2913-4fc0-8f91-af100f37562f/
Content-Type: application/json
{
"policyId": "00000000-0000-0000-0000-000000000000"
}