Planner tasks and plans API overview
The Planner API in Microsoft Graph provides a simple and visual way for teams to organize their work. Customers can use Planner to create plans, organize and assign tasks, share progress, and collaborate on content. Planner provides several interactive experiences including a task board, a charts page, and a schedule view, as well as integrations throughout Microsoft 365.
Microsoft 365 Planner task board
Why integrate with Planner tasks?
Planner provides task tracking capabilities for collaboration experiences in Microsoft 365. If your scenarios require tracking tasks and organizing work for a team or group of end users, Planner is the right service for you. Planner integration can help you reach the millions of users collaborating on Microsoft 365.
Organize your team’s work
Planner provides a shared space where you can build a team, create tasks, and assign them to others on the team. Planner makes it easy for everyone to know who’s doing what and if things are on track. You can update tasks with additional information like due dates, progress, and descriptions, and then further organize tasks with customizable buckets and category labels.
Collaborate across Microsoft 365
Planner integrates into collaboration experiences across Microsoft 365. In addition to Planner web and mobile clients, users can view and update Planner plans, Project tasks, and tasks from within SharePoint and Microsoft Teams. Note that the changes to Project tasks are limited to updating the progress (percentage complete) of the task and marking the task as complete.
Planner itself is also powered by the Microsoft Graph and the Microsoft 365 group service. Files that you upload and attach to Planner tasks are stored in SharePoint. Planner comments are based on Outlook group conversations.
Business scenario support
Planner supports business scenarios. Using the business scenarios API, you can create tasks and plans for your business processes, and control the tasks and the user experience around these tasks from the scenario configuration. Learn more about business scenarios.
Top Planner API tasks
| Operation | URL |
|---|---|
| See all the plans for a group | GET https://graph.microsoft.com/v1.0/groups/{id}/planner/plans |
| See tasks in a plan | GET https://graph.microsoft.com/v1.0/planner/plans/{id}/tasks |
| See all my tasks assigned to me across plans | GET https://graph.microsoft.com/v1.0/me/planner/tasks/ |
| Create a new task | POST https://graph.microsoft.com/v1.0/planner/tasks |
| Update a task | PATCH https://graph.microsoft.com/v1.0/planner/tasks/{task-id} |
| Delete a task | DELETE https://graph.microsoft.com/v1.0/planner/tasks/{id} |
API reference
Looking for the API reference for this service?