{"id":5211,"date":"2020-08-21T14:50:21","date_gmt":"2020-08-21T21:50:21","guid":{"rendered":"https:\/\/officedevblogs.wpengine.com\/?p=5211"},"modified":"2020-08-21T14:50:21","modified_gmt":"2020-08-21T21:50:21","slug":"the-new-improved-microsoft-graph-to-do-apis-are-now-in-public-preview","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/the-new-improved-microsoft-graph-to-do-apis-are-now-in-public-preview\/","title":{"rendered":"The new & improved Microsoft Graph To Do APIs are now in Public Preview"},"content":{"rendered":"

At Microsoft Build 2020, we introduced<\/a> the new Microsoft Graph To Do APIs<\/a>. Today, we\u2019re excited to announce that APIs are now available in public preview on the beta endpoint of Graph.<\/p>\n

Microsoft To Do<\/a> and Planner<\/a> form the backbone of tasks in Microsoft 365. To Do<\/a> is ideal for managing personal tasks across work and life while Planner is great for team tasks. Tasks come from everywhere, and millions of people use To Do as single destination to understand and manage their personal tasks. Besides offering best in class mobile apps for Android, iOS, Windows, Mac, and web, To Do is also deeply integrated with Microsoft 365 hubs<\/a>, Outlook<\/a>, and Teams<\/a>. Using the new APIs, developers can bring tasks from their apps into To Do and become a core part of users\u2019 productivity stories in Microsoft 365.<\/p>\n

API details<\/h3>\n

We have a todoTaskList<\/em><\/strong> entity, consisting of a collection of todoTask<\/em><\/strong> entities. Also, we are introducing a new entity called linkedResource<\/em> <\/strong>which enables task completion. You can use it to store and display the link back to the item in your app from where the task was created.<\/p>\n

\"a<\/p>\n

The new APIs support work, school, and personal Microsoft accounts. The required permission scope is Tasks.ReadWrite<\/a>. We\u2019ll support the following endpoints:<\/p>\n\n\n\n\n\n
CRUD operation on todoTaskList entity<\/a><\/td>\n\u00a0\/me\/todo\/lists<\/td>\n<\/tr>\n
CRUD operation on todoTask entity<\/a><\/td>\n\u00a0\/me\/todo\/lists\/<listId>\/tasks<\/td>\n<\/tr>\n
CRUD operation on linkedResource entity<\/a><\/td>\n\u00a0\/me\/todo\/lists\/<listId>\/tasks\/<taskId>\/linkedResources<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Here are some examples of requests and responses with the new APIs.<\/p>\n

    \n
  1. List all task lists<\/a><\/li>\n
  2. Create task in a task list<\/a><\/li>\n
  3. Create linked resource<\/a><\/li>\n<\/ol>\n

    Use cases<\/h3>\n

    Partners in our preview program are using To Do APIs to support the following use cases:<\/p>\n

      \n
    1. Create tasks from your app\u2019s workflow (tasks from email, notifications, etc.) and save them into To Do. (Don\u2019t forget to use the linkedResource<\/em> entity to store the link back to your app!)<\/li>\n
    2. Sync your app\u2019s existing tasks with To Do and create a single task view for better task prioritization and manageability.<\/li>\n<\/ol>\n
        \n
      1. Manage user To Do tasks in your custom business application.<\/li>\n<\/ol>\n

        To see this in action, check out our partner demos in our Build 2020 session<\/a>.<\/p>\n

        Deprecation of Outlook Tasks APIs<\/h3>\n

        Microsoft To Do is the upgraded version of the classic Outlook Tasks experience. The underlying storage and basic schema are exactly same. But with its new modern experience, To Do brings new modern task management capabilities like linkedResource<\/em>, data<\/em> extensions<\/em><\/a>, and more.<\/p>\n

        We\u2019re replacing the Outlook Tasks experience with To Do, starting with Outlook for the web. Replacing APIs is a crucial part of this modernization. Now that the To Do APIs are available in beta, developers should update any existing processes or integrations that use the Graph Outlook Tasks beta APIs<\/a> so, they can use the new To Do APIs. We\u2019re deprecating Outlook Tasks APIs with this release. Graph Outlook Tasks APIs will stop returning data after August 20, 2022.<\/strong><\/p>\n

        Apart from the new capabilities, To Do APIs has most of the Outlook Task capabilities. Please note that outlookTaskGroup<\/em><\/a> entity, extended properties<\/em> and assignedTo<\/em>, owner properties of outlookTask<\/em><\/a> entity won\u2019t be available in To Do APIs. We hope to release few other outlookTask properties like attachments<\/em>, categories<\/em>,<\/em> etc. in future releases. Please let us know on our User Voice<\/a> page if you would like us to prioritize any particular capability.<\/p>\n

        To transition to the new APIs, some query changes are necessary. For example, to get the properties and relationships of a task, the old query would look like:<\/p>\n

        GET https:\/\/graph.microsoft.com\/beta\/me\/outlook\/tasks\/{id}<\/p>\n

        The new query will look like:<\/p>\n

        GET https:\/\/graph.microsoft.com\/beta\/me\/todo\/lists\/{id}\/tasks\/{id}<\/a><\/p>\n

        For more information check out the documentation<\/a>.<\/p>\n

        Next steps<\/h3>\n

        We expect to make To Do APIs generally available on Microsoft Graph by the end of 2020. Our API roadmap contains previews of new capabilities like webhooks<\/em>.<\/p>\n

        You can use the preview of To Do component<\/a> from Microsoft Graph Toolkit<\/a> for reusable, framework-agnostic web components and helpers for accessing and working with Microsoft Graph.<\/p>\n

        We can\u2019t wait to see what you\u2019ll do with the new To Do APIs.\u00a0 You can explore them now on Microsoft Graph Explorer<\/a>, and if you have any feedback, suggestions or question, email us at\u00a0todofeedback@microsoft.com<\/a>\u00a0or let us know on our\u00a0UserVoice<\/a>\u00a0page or on Stack Overflow<\/a>.<\/p>\n

         <\/p>\n","protected":false},"excerpt":{"rendered":"

        We\u2019re excited to announce that APIs are now available in public preview on the beta endpoint of Graph.<\/p>\n","protected":false},"author":69076,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[],"class_list":["post-5211","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph"],"acf":[],"blog_post_summary":"

        We\u2019re excited to announce that APIs are now available in public preview on the beta endpoint of Graph.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/5211","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=5211"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/5211\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=5211"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=5211"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=5211"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}