{"id":4699,"date":"2020-05-20T08:03:43","date_gmt":"2020-05-20T15:03:43","guid":{"rendered":"https:\/\/officedevblogs.wpengine.com\/?p=4699"},"modified":"2020-05-20T08:03:43","modified_gmt":"2020-05-20T15:03:43","slug":"introducing-the-new-microsoft-graph-to-do-api","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/introducing-the-new-microsoft-graph-to-do-api\/","title":{"rendered":"Introducing the new Microsoft Graph To Do API"},"content":{"rendered":"

In a Workfront Inc study<\/a> of knowledge workers, 71% of respondents said that they needed a single destination<\/strong> to understand and manage their work. Microsoft To Do<\/a> is that single destination for your users\u2019 tasks in Microsoft 365. Today, we\u2019re excited to announce a preview of the Microsoft Graph To Do API, developed for partners like you to bring tasks from your apps in To Do.<\/p>\n

To Do and Planner<\/a> form the backbone of tasks in Microsoft 365. To Do is ideal for personal tasks across work and life whereas Planner is ideal for team tasks. Besides best in class mobile apps for Android, iOS, Windows, Mac, and web, To Do is also deeply integrated with Microsoft 365 hubs, Outlook<\/a>, and Teams<\/a>. Millions of users are using To Do to collect tasks from email, chats, and planner boards into one simple cohesive view. The To Do API opens up the opportunity for you to be a core part of these users\u2019 productivity story.<\/p>\n

\"Microsoft<\/p>\n

API details<\/h3>\n

To Do helps people organize their tasks into task lists. Tasks typically have productivity properties like due date, reminder time, notes, etc. Our new API is designed with a range of typical tasks in mind. We have a taskList<\/strong> entity, consisting of a collection of task<\/strong> entities. We\u2019re also adding a new entity called linkedResource <\/strong>to enable task completion. You can use it to store and display the link back to your app from where the task was created.<\/p>\n

\"Fig:<\/p>\n

We\u2019ll offer a preview version of our new API that supports work, school, and personal Microsoft accounts, but note that we will only support delegated access<\/a> in the first release. The required permission scopes are Tasks.Read, Tasks.ReadWrite and Tasks.ReadWrite.Shared. You’ll find support for the following endpoints:<\/p>\n\n\n\n\n\n
CRUD operation on TaskList entity<\/td>\n\u00a0\/me\/todo\/lists<\/td>\n<\/tr>\n
CRUD operation on Task entity<\/td>\n\u00a0\/me\/todo\/lists\/<listId>\/tasks<\/td>\n<\/tr>\n
CRUD operation on LinkedResource entity<\/td>\n\u00a0\/me\/todo\/lists\/<listId>\/tasks\/<taskId>\/linkedResources<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Build session & partner demo<\/h3>\n

Watch the Build 2020 session, \u201cBuilding apps for modern productivity with To Do in Microsoft Graph\u201d to learn more about To Do, its APIs on Microsoft Graph, and how partners are using it to bring tasks from their apps to To Do.<\/p>\n

The session features demos from two of our early partners: yasoon and Pleexy. yasoon is a German company with over 7 years of experience connecting Microsoft software with Atlassian products. Tune in to watch co-founder Andreas Schmidt demonstrate their latest add-in, “Microsoft To Do for Jira”. Pleexy is a fast-growing startup that channels tasks from third party productivity apps into To Do. Denise Rebollido, community manager at Pleexy, will showcase how Pleexy can be used to connect products like Trello and Asana with Microsoft To Do.<\/p>\n

To send us feedback or let us know if you want early access to the APIs, email us at todofeedback@microsoft.com<\/a> or head to our User Voice<\/a> page. We’d also love to hear your feedback about the Build session at aka.ms\/todosessionfeedback<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

Today, we\u2019re excited to announce a preview of the Microsoft Graph To Do API, developed for partners like you to bring tasks from your apps in To Do.<\/p>\n","protected":false},"author":69076,"featured_media":4701,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[],"class_list":["post-4699","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph"],"acf":[],"blog_post_summary":"

Today, we\u2019re excited to announce a preview of the Microsoft Graph To Do API, developed for partners like you to bring tasks from your apps in To Do.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/4699","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69076"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=4699"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/4699\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/4701"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=4699"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=4699"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=4699"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}