Skip to main content
Version: Insiders

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.insiders.easylife365.cloud/admin/Config.ReadWrite.All
ApplicationNot supported.

HTTP Request

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

POST 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"
}