todo task add¶
Adds a task to a Microsoft To Do list
Usage¶
m365 todo task add [options]
Options¶
-t, --title <title>
- The title of the task.
--listName [listName]
- The name of the list in which to create the task. Specify either
listName
orlistId
, but not both. --listId [listId]
- The id of the list in which to create the task. Specify either
listName
orlistId
, but not both. --bodyContent [bodyContent]
- The body content of the task. In the UI this is called 'notes'.
--bodyContentType [bodyContentType]
- The type of the body content. Possible values are
text
andhtml
. Default istext
. --dueDateTime [dueDateTime]
- The date when the task is due. This should be defined as a valid ISO 8601 string in the UTC time zone. Only date value is needed, time value is always ignored.
--importance [importance]
- The importance of the task. Possible values are:
low
,normal
,high
. Default isnormal
. --reminderDateTime [reminderDateTime]
- The date and time for a reminder alert of the task to occur. This should be defined as a valid ISO 8601 string in the UTC time zone.
-h, --help [help]
- Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are
options
,examples
,remarks
,response
,full
. Default isfull
. --query [query]
- JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
- Output type.
json,text,csv,md
. Defaultjson
--verbose
- Runs command with verbose logging
--debug
- Runs command with debug logging
Examples¶
Add a task to Microsoft To Do tasks list with with a specific name
m365 todo task add --title "New task" --listName "My task list"
Add a task to a Microsoft To Do tasks list with a specific id
m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA=="
Create a new task with bodyContent and reminder and flag it as important
m365 todo task add --title "New task" --listName "My task list" --bodyContent "I should not forget this" --reminderDateTime 2023-01-01T12:00:00Z --importance high
Create a new task with a specific due date
m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
Response¶
Standard response¶
{
"importance": "high",
"isReminderOn": true,
"status": "notStarted",
"title": "New task",
"createdDateTime": "2022-10-29T10:54:06.3672421Z",
"lastModifiedDateTime": "2022-10-29T10:54:06.5078837Z",
"hasAttachments": false,
"categories": [],
"id": "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=",
"body": {
"content": "I should not forget this",
"contentType": "text"
},
"dueDateTime": {
"dateTime": "2023-01-01T00:00:00.0000000",
"timeZone": "UTC"
},
"reminderDateTime": {
"dateTime": "2023-01-01T12:00:00.0000000",
"timeZone": "UTC"
}
}
body : {"content":"I should not forget this","contentType":"text"}
categories : []
createdDateTime : 2022-10-29T10:54:06.3672421Z
dueDateTime : {"dateTime":"2023-01-01T00:00:00.0000000","timeZone":"UTC"}
hasAttachments : false
id : AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=
importance : high
isReminderOn : true
lastModifiedDateTime: 2022-10-29T10:54:06.5078837Z
reminderDateTime : {"dateTime":"2023-01-01T12:00:00.0000000","timeZone":"UTC"}
status : notStarted
title : New task
importance,isReminderOn,status,title,createdDateTime,lastModifiedDateTime,hasAttachments,categories,id,body,dueDateTime,reminderDateTime
high,1,notStarted,New task,2022-10-29T10:54:06.3672421Z,2022-10-29T10:54:06.5078837Z,,[],AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=,"{""content"":""I should not forget this"",""contentType"":""text""}","{""dateTime"":""2023-01-01T00:00:00.0000000"",""timeZone"":""UTC""}","{""dateTime"":""2023-01-01T12:00:00.0000000"",""timeZone"":""UTC""}"