{"id":12991,"date":"2023-02-24T09:24:21","date_gmt":"2023-02-24T17:24:21","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=12991"},"modified":"2023-02-24T09:24:21","modified_gmt":"2023-02-24T17:24:21","slug":"new-capabilities-available-in-microsoft-graph-to-do-apis","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/new-capabilities-available-in-microsoft-graph-to-do-apis\/","title":{"rendered":"New capabilities available in Microsoft Graph To Do APIs\u00a0"},"content":{"rendered":"

We strive to provide enhanced capabilities for the Microsoft Graph To Do task APIs while keeping customer needs at the core. <\/span>We are thrilled to announce new capabilities like application permissions support, attachment support and \u2018startDateTime\u2019 property on To Do task APIs.<\/span><\/b>\u00a0<\/span>\u00a0<\/span><\/p>\n

Application permissions<\/span>\u00a0<\/span><\/h2>\n

Application permissions has been one of the top asks from customers since we released the To Do task APIs. Recently, we have released application permissions for To Do APIs in Graph v1.0. With application permissions, developers can build daemon services and make To Do part of workflows which will not require any interaction for sign-in or consent. Application permission can also be used to create tools that help tenant admins with To Do tasks usage analytics.\u00a0<\/span>\u00a0<\/span><\/p>\n

Please note, tenant admin consent will be required to access APIs with application permissions.<\/span><\/b>\u00a0<\/span><\/p>\n\n\n\n\n\n
Scope Name<\/span><\/b>\u00a0<\/span><\/td>\nEntities\/API covered<\/span><\/b>\u00a0<\/span><\/td>\n<\/tr>\n
Tasks.Read.All<\/span><\/b>\u00a0<\/span><\/td>\nRead operation on <\/span>todoTask, todoTaskList, taskFileAttachment, checklistItems, linkedResource<\/span>\u00a0<\/span><\/p>\n

\u00a0\u00a0<\/span>\u00a0<\/span><\/td>\n<\/tr>\n

Tasks.ReadWrite.All<\/span><\/b>\u00a0<\/span><\/td>\nRead and write operations on <\/span>todoTask, todoTaskList, taskFileAttachment, checklistItems, linkedResource<\/span>\u00a0<\/span><\/p>\n

\u00a0<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Accessing Microsoft Graph APIs using application permissions is an existing pattern. Read more about application permissions in our <\/span>documentation<\/span><\/a>.\u00a0<\/span>\u00a0<\/span><\/p>\n

A sample <\/span>GET <\/span><\/b>task using app permission: <\/span>https:\/\/graph.microsoft.com\/v1.0\/users\/234jk-nse764304-nsfp\/todo\/lists\/AAMkADA1MTHgwAAA=\/tasks\/721a35e2-35e2-721a-e235-1a72e2351a72<\/span><\/a>\n\u00a0<\/span><\/p>\n

Response<\/span><\/b>\u00a0<\/span><\/p>\n

HTTP\/1.1 200 OK \r\n\r\nContent-Type: application\/json \r\n\r\n{ \r\n\r\n    \"@odata.context\": \"https:\/\/graph.microsoft.com\/v1.0\/$metadata#tasks\/$entity\", \r\n\r\n    \"@odata.etag\": \"W\/\\\"s8\/ERWT3WEeFpBGD0bDgAA+TWq9g==\\\"\", \r\n\r\n    \"importance\": \"low\", \r\n\r\n    \"isReminderOn\": false, \r\n\r\n    \"status\": \"notStarted\", \r\n\r\n    \"title\": \"Shop for dinner\", \r\n\r\n    \"createdDateTime\": \"2020-07-22T10:39:03.7937971Z\", \r\n\r\n    \"lastModifiedDateTime\": \"2020-07-22T12:02:10.8835421Z\", \r\n\r\n    \"categories\": [ \r\n\r\n       \"Important\", \r\n\r\n       \"Urgent\" \r\n\r\n            ], \r\n\r\n    \"id\": \"721a35e2-35e2-721a-e235-1a72e2351a72\", \r\n\r\n    \"body\": { \r\n\r\n        \"content\": \"\", \r\n\r\n        \"contentType\": \"text\" \r\n\r\n    }, \r\n\r\n    \"dueDateTime\": { \r\n\r\n        \"dateTime\": \"2020-08-25T04:00:00.0000000\", \r\n\r\n        \"timeZone\": \"UTC\" \r\n\r\n    }, \r\n\r\n    \"startDateTime\": { \r\n\r\n        \"dateTime\": \"2020-06-23T04:00:00.0000000\", \r\n\r\n        \"timeZone\": \"UTC\" \r\n\r\n    } \r\n\r\n} <\/code><\/pre>\n
Attachments<\/span>\u00a0<\/span><\/h2>\n
We are also announcing attachment support on todoTasks in Microsoft Graph v1.0. Now, you can read, upload, and delete\u202f<\/span>file attachments<\/span><\/a>\u202fon a task. There are two methods to upload attachments on a task:<\/span>\u00a0<\/span><\/p>\n
    \n
  1. To attach files of any size,\u202f<\/span>create an upload session<\/span><\/a>, and iteratively use PUT call to upload ranges of bytes of the file until you have uploaded the entire file. See\u202f<\/span>attach files to a To Do task<\/span><\/a>\u202ffor an example.<\/span>\u00a0<\/span><\/li>\n<\/ol>\n
      \n
    1. If the file size is under 3 MB, you can do a single POST on the attachment\u2019s navigation property of\u202f<\/span>todoTask<\/span><\/a>; See\u202f<\/span>create attachment<\/span><\/a>\u202ffor an example.<\/span>\u00a0<\/span><\/li>\n<\/ol>\n
      StartDateTime<\/span>\u00a0<\/span><\/p>\n
      startDateTime property on todoTask lets you set the date when tasks would be started. Now, API responses will have startDateTime when querying for users\u2019 task.<\/span>\u00a0<\/span><\/p>\n
      Example: <\/span><\/b>A sample for PATCH task (existing task) using app permission is like below.<\/span>\u00a0<\/span><\/p>\n
      PATCH <\/span>https:\/\/graph.microsoft.com\/v1.0\/me\/todo\/lists\/AAMkADA1MTHgwAAA=\/tasks\/721a35e2-35e2-721a-e235-1a72e2351a72<\/span><\/a>\u00a0<\/span>\u00a0<\/span><\/p>\n
      Request<\/span><\/b>:<\/span>\u00a0<\/span>\u00a0<\/span><\/p>\n
      {<\/span>\u00a0<\/span>\u00a0<\/span><\/p>\n
      “startDateTime”: {<\/span>\u00a0<\/span>\u00a0<\/span><\/p>\n
      \u00a0\u00a0\u00a0 “dateTime”: “2020-06-23T04:00:00.0000000”,<\/span>\u00a0<\/span>\u00a0<\/span><\/p>\n
      \u00a0\u00a0\u00a0 “timeZone”: “UTC”<\/span>\u00a0<\/span>\u00a0<\/span><\/p>\n
      \u00a0 }<\/span>\u00a0<\/span>\u00a0<\/span><\/p>\n
      }<\/span>\u00a0<\/span>\u00a0<\/span><\/p>\n
      Response<\/span><\/b><\/p>\n
      {  \r\n\r\n\"startDateTime\": {  \r\n\r\n    \"dateTime\": \"2020-06-23T04:00:00.0000000\",  \r\n\r\n    \"timeZone\": \"UTC\"  \r\n\r\n  }  \r\n\r\n}  \r\n\r\nResponse  \r\nHTTP\/1.1 200 OK \r\n\r\nContent-Type: application\/json \r\n\r\n { \r\n\r\n    \"@odata.context\": \"https:\/\/graph.microsoft.com\/v1.0\/$metadata#tasks\/$entity\", \r\n\r\n    \"@odata.etag\": \"W\/\\\"s8\/ERWT3WEeFpBGD0bDgAA+TWq9g==\\\"\", \r\n\r\n    \"importance\": \"low\", \r\n\r\n    \"isReminderOn\": false, \r\n\r\n    \"status\": \"notStarted\", \r\n\r\n    \"title\": \"Shop for dinner\", \r\n\r\n    \"createdDateTime\": \"2020-07-22T10:39:03.7937971Z\", \r\n\r\n    \"lastModifiedDateTime\": \"2020-07-22T12:02:10.8835421Z\", \r\n\r\n    \"categories\": [ \r\n\r\n       \"Important\", \r\n\r\n       \"Urgent\" \r\n\r\n            ], \r\n\r\n    \"id\": \"721a35e2-35e2-721a-e235-1a72e2351a72\", \r\n\r\n    \"body\": { \r\n\r\n        \"content\": \"\", \r\n\r\n        \"contentType\": \"text\" \r\n\r\n    }, \r\n\r\n    \"dueDateTime\": { \r\n\r\n        \"dateTime\": \"2020-08-25T04:00:00.0000000\", \r\n\r\n        \"timeZone\": \"UTC\" \r\n\r\n    }, \r\n\r\n    \"startDateTime\": { \r\n\r\n        \"dateTime\": \"2020-06-23T04:00:00.0000000\", \r\n\r\n        \"timeZone\": \"UTC\" \r\n\r\n    } \r\n\r\n} <\/code><\/pre>\n
      We cannot wait for you to try out these APIs. Thank you for continuing with us on this journey as we continue to work towards improving productivity. <\/span>If you have any feedback, suggestions, or question, <\/span>email us<\/span><\/a> or let us know on our <\/span>feedback<\/span><\/a> page.<\/span><\/p>\n
      Happy coding!<\/span>\u00a0<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"
      We are thrilled to announce new capabilities like application permissions support, attachment support and \u2018startDateTime\u2019 property on To Do task APIs.\u00a0\u00a0<\/p>\n","protected":false},"author":112780,"featured_media":13015,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[156],"class_list":["post-12991","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-to-do-api"],"acf":[],"blog_post_summary":"
      We are thrilled to announce new capabilities like application permissions support, attachment support and \u2018startDateTime\u2019 property on To Do task APIs.\u00a0\u00a0<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/12991","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\/112780"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=12991"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/12991\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/13015"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=12991"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=12991"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=12991"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}