Skip to content

Commit 21458bf

Browse files
fix url
1 parent f9818e7 commit 21458bf

File tree

2 files changed

+27
-2
lines changed

2 files changed

+27
-2
lines changed

api-reference/beta/resources/planner-overview.md

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ You can use the Planner API in Microsoft Graph to create tasks and assign them t
1717
Before you get started with the Planner API, it's helpful to understand how the main objects relate to each other and to Microsoft 365 groups.
1818

1919
## Plan containers
20-
In Microsoft Planner, plans are always contained in another resource. The containing resource, [plannerPlanContainer](plannerplancontainer.md), determines the authorization rules of the plan and all the tasks in it, and the lifecycle of the plan. You can create a plan in a container of one of the following types: [driveItem](driveitem.md), Microsoft 365 [group](group.md), Planner project, [roster](plannerroster.md), or [user](user.md).
20+
In Microsoft Planner, plans are always contained in another resource. The containing resource, [plannerPlanContainer](plannerplancontainer.md), determines the authorization rules of the plan and all the tasks in it, and the lifecycle of the plan. You can create a plan in a container of one of the following types: [driveItem](driveitem.md), Microsoft 365 [group](group.md), Planner project, [roster](plannerroster.md), [teamsChannel](channel.md), or [user](user.md).
2121

2222
The most common type of container is a group.
2323

@@ -65,6 +65,31 @@ Alternatively, you can specify the URL for a user.
6565

6666
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`.
6767

68+
### Container type: Teams Channel
69+
70+
The Teams channel container type supports plans created in Teams shared channels, where the channel is the container for the plan. Plans that are pinned in the shared channels would be deleted when the channel is deleted.
71+
72+
To [create a new plan](../api/planner-post-plans.md) in a Teams channel's container, set the **container** property on a [plan](plannerplan.md) object with **type** being `teamsChannel`, and the id should be formatted at "{team-id}/channels/{channel-id}
73+
74+
```json
75+
{
76+
"container": {
77+
"id": "00000000-0000-0000-0000-000000000000",
78+
"type": "teamsChannel"
79+
}
80+
}
81+
```
82+
83+
Alternatively, you can specify the URL for a Teams shared channel.
84+
85+
```json
86+
{
87+
"container": {
88+
"url": "https://graph.microsoft.com/beta/teams/{teamId}/channels/{channelId}"
89+
}
90+
}
91+
```
92+
6893
## Plans
6994

7095
[Plans](plannerplan.md) are the containers of [tasks](plannertask.md).

changelog/Microsoft.Tasks.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@
2323
"ApiChange": "Resource",
2424
"ChangedApiName": "teamsChannelPlanner",
2525
"ChangeType": "Addition",
26-
"Description": "Added the [teamsChannelPlanner](https://learn.microsoft.com/en-us/graph/api/resources/teamsChannelPlanner?view=graph-rest-beta) resource.",
26+
"Description": "Added the [teamsChannelPlanner](https://learn.microsoft.com/en-us/graph/api/resources/channel?view=graph-rest-beta) resource.",
2727
"Target": "teamsChannelPlanner"
2828
}
2929
],

0 commit comments

Comments
 (0)