Update planner overview with Teams channel container type

JarbasHorst · web-flow · commit d2cdd7c5871d · 2025-01-13T21:32:41.000+01:00
diff --git a/api-reference/beta/resources/planner-overview.md b/api-reference/beta/resources/planner-overview.md
@@ -37,59 +37,58 @@ When you [create a new plan](../api/planner-post-plans.md), set the **container*
 
 >**Note:** The user who creates the plan must be a member of the group that contains the plan. When you create a new group by using [Create group](../api/group-post-groups.md), you aren't added to the group as a member. After the group is created, add yourself as a member by using [group post members](../api/group-post-members.md).
 
+### Container type: Teams channel
 
-### Container type: User
-
-The user container type supports personal plans, where the user is the only user tracking their individual tasks. This provides the flexibility for users to share or collaborate on their personal plans. Plans that are created for a single user are automatically deleted when the user is deleted.
+The `teamsChannel` container type supports plans created in shared channels in Teams, where the channel is the container for the plan. Plans that are pinned in shared channels are deleted when the channel is deleted.
 
-To [create a new plan](../api/planner-post-plans.md) in a user's container, set the **container** property on a [plan](plannerplan.md) object with **type** being `user`.
+To [create a new plan](../api/planner-post-plans.md) in the container of a Teams channel, set the **container** property on a [plan](plannerplan.md) object with **type** as `teamsChannel`, and the ID should be formatted as "{team-id}/channels/{channel-id}".
 
 ```json
 {
     "container": {
-        "id": "00000000-0000-0000-0000-000000000000",
-        "type": "user"
+        "id": "{team-id}/channels/{channel-id}",
+        "type": "teamsChannel"
     }
 }
 ```
 
-Alternatively, you can specify the URL for a user.
+Alternatively, you can specify the URL for a shared channel in Teams.
 
 ```json
 {
     "container": {
-        "url": "https://graph.microsoft.com/beta/users/me"
+        "url": "https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}"
     }
 }
 ```
 
-Users can upgrade their personal plans into group-based plans by [moving](../api/plannerplan-movetocontainer.md) the plan from the user container to a group container, changing the type of the container for the plan from `user` to `group`. 
-
-### Container type: Teams channel
+### Container type: User
 
-The `teamsChannel` container type supports plans created in shared channels in Teams, where the channel is the container for the plan. Plans that are pinned in shared channels are deleted when the channel is deleted.
+The user container type supports personal plans, where the user is the only user tracking their individual tasks. This provides the flexibility for users to share or collaborate on their personal plans. Plans that are created for a single user are automatically deleted when the user is deleted.
 
-To [create a new plan](../api/planner-post-plans.md) in the container of a Teams channel, set the **container** property on a [plan](plannerplan.md) object with **type** as `teamsChannel`, and the ID should be formatted as "{team-id}/channels/{channel-id}".
+To [create a new plan](../api/planner-post-plans.md) in a user's container, set the **container** property on a [plan](plannerplan.md) object with **type** being `user`.
 
 ```json
 {
     "container": {
-        "id": "{team-id}/channels/{channel-id}",
-        "type": "teamsChannel"
+        "id": "00000000-0000-0000-0000-000000000000",
+        "type": "user"
     }
 }
 ```
 
-Alternatively, you can specify the URL for a shared channel in Teams.
+Alternatively, you can specify the URL for a user.
 
 ```json
 {
     "container": {
-        "url": "https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}"
+        "url": "https://graph.microsoft.com/beta/users/me"
     }
 }
 ```
 
+Users can upgrade their personal plans into group-based plans by [moving](../api/plannerplan-movetocontainer.md) the plan from the user container to a group container, changing the type of the container for the plan from `user` to `group`. 
+
 ## Plans
 
 [Plans](plannerplan.md) are the containers of [tasks](plannertask.md).

Original file line number	Diff line number	Diff line change
`@@ -37,59 +37,58 @@ When you [create a new plan](../api/planner-post-plans.md), set the *container`
`37`	`37`
`38`	`38`	`>Note: The user who creates the plan must be a member of the group that contains the plan. When you create a new group by using [Create group](../api/group-post-groups.md), you aren't added to the group as a member. After the group is created, add yourself as a member by using [group post members](../api/group-post-members.md).`
`39`	`39`
	`40`	`+### Container type: Teams channel`
`40`	`41`
`41`		`-### Container type: User`
`42`		`-`
`43`		`-The user container type supports personal plans, where the user is the only user tracking their individual tasks. This provides the flexibility for users to share or collaborate on their personal plans. Plans that are created for a single user are automatically deleted when the user is deleted.`
	`42`	+The `teamsChannel` container type supports plans created in shared channels in Teams, where the channel is the container for the plan. Plans that are pinned in shared channels are deleted when the channel is deleted.
`44`	`43`
`45`		-To [create a new plan](../api/planner-post-plans.md) in a user's container, set the container property on a [plan](plannerplan.md) object with type being `user`.
	`44`	+To [create a new plan](../api/planner-post-plans.md) in the container of a Teams channel, set the container property on a [plan](plannerplan.md) object with type as `teamsChannel`, and the ID should be formatted as "{team-id}/channels/{channel-id}".
`46`	`45`
`47`	`46`	```json
`48`	`47`	`{`
`49`	`48`	`"container": {`
`50`		`- "id": "00000000-0000-0000-0000-000000000000",`
`51`		`- "type": "user"`
	`49`	`+ "id": "{team-id}/channels/{channel-id}",`
	`50`	`+ "type": "teamsChannel"`
`52`	`51`	`}`
`53`	`52`	`}`
`54`	`53`	```
`55`	`54`
`56`		`-Alternatively, you can specify the URL for a user.`
	`55`	`+Alternatively, you can specify the URL for a shared channel in Teams.`
`57`	`56`
`58`	`57`	```json
`59`	`58`	`{`
`60`	`59`	`"container": {`
`61`		`- "url": "https://graph.microsoft.com/beta/users/me"`
	`60`	`+ "url": "https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}"`
`62`	`61`	`}`
`63`	`62`	`}`
`64`	`63`	```
`65`	`64`
`66`		-Users can upgrade their personal plans into group-based plans by [moving](../api/plannerplan-movetocontainer.md) the plan from the user container to a group container, changing the type of the container for the plan from `user` to `group`.
`67`		`-`
`68`		`-### Container type: Teams channel`
	`65`	`+### Container type: User`
`69`	`66`
`70`		-The `teamsChannel` container type supports plans created in shared channels in Teams, where the channel is the container for the plan. Plans that are pinned in shared channels are deleted when the channel is deleted.
	`67`	`+The user container type supports personal plans, where the user is the only user tracking their individual tasks. This provides the flexibility for users to share or collaborate on their personal plans. Plans that are created for a single user are automatically deleted when the user is deleted.`
`71`	`68`
`72`		-To [create a new plan](../api/planner-post-plans.md) in the container of a Teams channel, set the container property on a [plan](plannerplan.md) object with type as `teamsChannel`, and the ID should be formatted as "{team-id}/channels/{channel-id}".
	`69`	+To [create a new plan](../api/planner-post-plans.md) in a user's container, set the container property on a [plan](plannerplan.md) object with type being `user`.
`73`	`70`
`74`	`71`	```json
`75`	`72`	`{`
`76`	`73`	`"container": {`
`77`		`- "id": "{team-id}/channels/{channel-id}",`
`78`		`- "type": "teamsChannel"`
	`74`	`+ "id": "00000000-0000-0000-0000-000000000000",`
	`75`	`+ "type": "user"`
`79`	`76`	`}`
`80`	`77`	`}`
`81`	`78`	```
`82`	`79`
`83`		`-Alternatively, you can specify the URL for a shared channel in Teams.`
	`80`	`+Alternatively, you can specify the URL for a user.`
`84`	`81`
`85`	`82`	```json
`86`	`83`	`{`
`87`	`84`	`"container": {`
`88`		`- "url": "https://graph.microsoft.com/beta/teams/{team-id}/channels/{channel-id}"`
	`85`	`+ "url": "https://graph.microsoft.com/beta/users/me"`
`89`	`86`	`}`
`90`	`87`	`}`
`91`	`88`	```
`92`	`89`
	`90`	+Users can upgrade their personal plans into group-based plans by [moving](../api/plannerplan-movetocontainer.md) the plan from the user container to a group container, changing the type of the container for the plan from `user` to `group`.
	`91`	`+`
`93`	`92`	`## Plans`
`94`	`93`
`95`	`94`	`[Plans](plannerplan.md) are the containers of [tasks](plannertask.md).`