plannerRoster resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a collection of users who are collaborating on a plannerPlan. A plannerRoster is a simple set of users, where everyone has the same level of permissions and they can be created by everyone, unless disabled by the tenant administrator. A plannerRoster can contain one plan.

Deleting a plannerRoster also deletes the plan and all tasks in the plan. A plannerRoster is also automatically deleted under the following conditions:

• The plannerRoster doesn't contain a plan 24 hours after its creation. Membership information is erased within 30 days of this deletion.
• The plannerRoster doesn't have any users remaining in the membership list because the last user removed themselves. Roster, its plan, and all contained tasks are deleted within 30 days of this operation.
• The plannerRoster doesn't have any users remaining in the membership list because the last user was permanently deleted. Roster, its plan, and all contained tasks are deleted immediately. Deleted users are permanently erased within 30 days of their deletion; however, tenant administrators can also choose to permanently delete users without this delay.

Methods

Method	Return type	Description
Create	plannerRoster	Create a new plannerRoster object.
Get	plannerRoster	Read the properties and relationships of a plannerRoster object.
Delete	None	Delete a plannerRoster object.
List members of roster	plannerRosterMember collection	Get the plannerRosterMember resources from the members navigation property.
Add member to roster	plannerRosterMember	Create a new plannerRosterMember object.
List plans in roster	plannerPlan collection	Get the plannerPlan resources from the plans navigation property.
List user's plans in rosters	plannerPlan collection	Get the plannerPlans contained by the plannerRosters that the user is a member.
Assign sensitivity label	plannerRoster]	Assign a sensitivity label to a plannerRoster object.

Properties

Property	Type	Description
assignedSensitivityLabel	sensitivityLabelAssignmentMethod	The sensitivity label applied to the roster. If mandatory labeling is enabled for the user and no label is specified, the user can't create the roster. Also, if labels are mandatory for the user, the user can't change the label of the roster to null. Possible values are: standard, privileged, auto, unknownFutureValue.
id	String	Identifier of the plannerRoster. Read only. Inherited from entity

Relationships

Relationship	Type	Description
members	plannerRosterMember collection	Retrieves the members of the plannerRoster.
plans	plannerPlan collection	Retrieves the plans contained by the plannerRoster.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.plannerRoster",
  "assignedSensitivityLabel": "#microsoft.graph.sensitivityLabelAssignment",
  "id": "String (identifier)"
}