Skip to main content
Version: 2.100.0

Manage Group Templates and Policies

EasyLife 365 Collaboration API enables the management of Microsoft 365 Group (including Teams) templates and policies.

Permissions

Permission TypePermissions (Scope)
Delegated (work or school account)https://api.easylife365.cloud/admin/Config.ReadWrite.All
ApplicationNot supported.

HTTP Request

POST https://api.easylife365.cloud/admin/collab/v1/manage/groups/{group-id}/
Content-Type: application/json

HTTP Request Headers

HeaderValue
AuthorizationBearer token. (Required)
Content-Typeapplication/json

Request Body

PropertyTypeDescription
templateIdStringID of the Guest Template (Optional)
policyIdStringID 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.

POST https://api.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.

POST https://api.easylife365.cloud/admin/collab/v1/manage/groups/57523d68-2913-4fc0-8f91-af100f37562f/
Content-Type: application/json
{
"policyId": "00000000-0000-0000-0000-000000000000"
}