@pnp/cli-microsoft365 6.0.0-beta.e7c60af → 6.0.0-beta.eb11cbe

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-list.md

@@ -29,6 +29,58 @@ Get service update messages for Microsoft Teams
 m365 tenant serviceannouncement message list --service "Microsoft Teams"
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "startDateTime": "2021-07-08T00:37:37Z",
+        "endDateTime": "2022-12-09T07:00:00Z",
+        "lastModifiedDateTime": "2022-06-07T20:21:06.713Z",
+        "title": "(Updated) Microsoft Lists: Custom list templates",
+        "id": "MC267581",
+        "category": "planForChange",
+        "severity": "normal",
+        "tags": [
+          "Updated message",
+          "New feature",
+          "User impact",
+          "Admin impact"
+        ],
+        "isMajorChange": false,
+        "actionRequiredByDateTime": null,
+        "services": [
+          "SharePoint Online"
+        ],
+        "expiryDateTime": null,
+        "hasAttachments": false,
+        "viewPoint": null,
+        "details": [],
+        "body": {
+          "contentType": "html",
+          "content": "<p>Updated June 7, 2022: We have updated the rollout timeline below. Thank you for your patience.</p><p>This new feature will support the addition of custom list templates from your organization alongside the ready-made templates Microsoft provides to make it easy to get started tracking and managing information.</p> \\\n<p>[Key points]</p> \\\n<ul> \\\n<li>Microsoft 365 <a href=\"https://www.microsoft.com/microsoft-365/roadmap?filters=&amp;searchterms=70753\" target=\"_blank\">Roadmap ID: 70753</a></li> \\\n<li>Timing:<ul><li>Targeted release (entire org): Complete</li><li>Standard release: will roll out in mid-September (previously mid-May) and be complete by early November (previously mid-June)</li></ul></li> \\\n<li>Roll-out: tenant level </li> \\\n<li>Control type: user control / admin control</li> \\\n<li>Action: review, assess and educate</li></ul><p>[How this will affect your organization]</p><p>This feature will give organizations the ability to create their own custom list templates with custom formatting and schema. It will also empower organizations to create repeatable solutions within the same Microsoft Lists infrastructure (including list creation in SharePoint, Teams, and within the Lists app itself).</p><p>End-user impact:</p>\\\n<p>Visual updates to the list creation dialog and the addition of a<i> From your organization</i> tab when creating a new list. This new tab is where your custom list templates appear alongside the ready-made templates from Microsoft.</p>\\\n<p><img src=\"https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81n?ver=c93f\" alt=\"Your custom list templates along with Microsoft ready-made templates\" width=\"550\"><br>\\\nAdmin impact:</p>\\\n<p>Custom list templates can only be uploaded by a SharePoint administrator for Microsoft 365 by using PowerShell cmdlets. For consistency, the process of defining and uploading custom list templates is like the custom site templates experience.</p><p>To define and upload custom list templates, admins will use the following site template PowerShell cmdlets:</p><ul><li>Use the <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/get-spositescriptfromlist?view=sharepoint-ps\" target=\"_blank\">Get-SPOSiteScriptFromList</a> cmdlet to extract the site script from any list</li><li>Run <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/add-spositescript?view=sharepoint-ps\" target=\"_blank\">Add-SPOSiteScript</a> and <b style=\"\">Add-SPOListDesign</b> to add the custom list template to your organization.</li><li>Scope who sees the template by using <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/grant-spositedesignrights?view=sharepoint-ps\" target=\"_blank\">Grant-SPOSiteDesignRights</a>  (Optional).</li></ul><p>The visual updates for this feature will be seen by end-users in the updated user interface (UI) when creating a list.</p><p>The <i>From your organization</i> tab will be empty until your organization defines and publishes custom list templates.</p>\\\n<p><img src=\"https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81t?ver=70be\" alt=\"Your custom list templates along with Microsoft ready-made templates\" width=\"550\"></p><p>[What you need to do to prepare]</p><p>You might want to notify your users about this new capability and update your training and documentation as appropriate.</p>\\\n<p>Learn more:</p><ul><li><a href=\"https://docs.microsoft.com/sharepoint/dev/declarative-customization/site-design-overview\" target=\"_blank\">PowerShell Cmdlets documentation for custom list templates</a></li><li> <a href=\"https://docs.microsoft.com/sharepoint/lists-custom-template\" target=\"_blank\">Creating custom list templates</a></li></ul>"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id        title
+    --------  ------------------------------------------------
+    MC267581  (Updated) Microsoft Lists: Custom list templates
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,title
+    MC267581,(Updated) Microsoft Lists: Custom list templates
+    ```
+ 
 ## More information
 
 - List serviceAnnouncement messages: [https://docs.microsoft.com/en-us/graph/api/serviceannouncement-list-messages](https://docs.microsoft.com/en-us/graph/api/serviceannouncement-list-messages)

package/docs/docs/cmd/todo/list/list-add.md

@@ -11,7 +11,7 @@ m365 todo list add [options]
 ## Options
 
 `-n, --name <name>`
-: The name of the task list to add
+: The name of the task list to add.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -22,3 +22,34 @@ Add a task list with the name _My task list_
 ```sh
 m365 todo list add --name "My task list"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "displayName": "My task list",
+      "isOwner": true,
+      "isShared": false,
+      "wellknownListName": "none",
+      "id": "AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA="
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    displayName      : My task list
+    id               : AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA=
+    isOwner          : true
+    isShared         : false
+    wellknownListName: none
+    ```
+    
+=== "CSV"
+
+    ```csv
+    displayName,isOwner,isShared,wellknownListName,id
+    My task list,1,,none,AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA=
+    ```

package/docs/docs/cmd/todo/list/list-get.md

@@ -0,0 +1,61 @@
+# todo list get
+
+Returns a specific Microsoft To Do task list
+
+## Usage
+
+```sh
+m365 todo list get [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: The id of the list. Specify either `id` or `name`, but not both.
+
+`-n, --name [name]`
+: The name of the list. Specify either `id` or `name`, but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get a specific Microsoft To Do task list based on id
+
+```sh
+m365 todo list get --id "AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA="
+```
+
+Get a specific Microsoft To Do task list based on name
+
+```sh
+m365 todo list get --name "Task list"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "displayName": "Task list",
+      "isOwner": true,
+      "isShared": false,
+      "wellknownListName": "defaultList",
+      "id": "AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA="
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    displayName    : Task list
+    id             : AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA=
+    ```
+
+=== "CSV"
+
+    ```csv
+    displayName,id
+    Task list,AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA=
+    ```

package/docs/docs/cmd/todo/list/list-list.md

@@ -19,3 +19,34 @@ Get the list of Microsoft To Do task lists
 ```sh
 m365 todo list list
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "displayName": "Tasks",
+        "isOwner": true,
+        "isShared": false,
+        "wellknownListName": "defaultList",
+        "id": "AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQAAAgESAAAA"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    displayName     id                                                                                                      
+    --------------  ------------------------------------------------------------------------------------------------------------------------
+    Tasks           AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQAAAgESAAAA
+    ```
+
+=== "CSV"
+
+    ```csv
+    displayName,id
+    Tasks,AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQAAAgESAAAA
+    ```

package/docs/docs/cmd/todo/list/list-remove.md

@@ -11,26 +11,30 @@ m365 todo list remove [options]
 ## Options
 
 `-n, --name [name]`
-: The name of the task list to remove. Specify either `id` or `name` but not both
+: The name of the task list to remove. Specify either `id` or `name`, but not both.
 
 `-i, --id [id]`
-: The ID of the task list to remove. Specify either `id` or `name` but not both
+: The ID of the task list to remove. Specify either `id` or `name`, but not both.
 
 `--confirm`
-: Don't prompt for confirming removing the task list
+: Don't prompt for confirming removing the task list.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Remove a task list with the name _My task list_
+Remove a task list with specific name
 
 ```sh
 m365 todo list remove --name "My task list"
 ```
 
-Remove a task list with the ID _AAMkAGI3NDhlZmQzLWQxYjAtNGJjNy04NmYwLWQ0M2IzZTNlMDUwNAAuAAAAAACQ1l2jfH6VSZraktP8Z7auAQCbV93BagWITZhL3J6BMqhjAAD9pHIhAAA=_
+Remove a task list with the ID without confirmation prompt
 
 ```sh
-m365 todo list remove --id "AAMkAGI3NDhlZmQzLWQxYjAtNGJjNy04NmYwLWQ0M2IzZTNlMDUwNAAuAAAAAACQ1l2jfH6VSZraktP8Z7auAQCbV93BagWITZhL3J6BMqhjAAD9pHIhAAA="
+m365 todo list remove --id "AAMkAGI3NDhlZmQzLWQxYjAtNGJjNy04NmYwLWQ0M2IzZTNlMDUwNAAuAAAAAACQ1l2jfH6VSZraktP8Z7auAQCbV93BagWITZhL3J6BMqhjAAD9pHIhAAA=" --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/todo/list/list-set.md

@@ -11,26 +11,30 @@ m365 todo list set [options]
 ## Options
 
 `-i, --id [id]`
-: The ID of the list to update. Specify either id or name, not both
+: The ID of the list to update. Specify either `id` or `name`, but not both.
 
 `-n, --name [name]`
-: The display name of the list to update. Specify either id or name, not both
+: The display name of the list to update. Specify either `id` or `name`, but not both.
 
 `--newName <newName>`
-: The new name for the task list
+: The new name for the task list.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Rename the list with ID _AAMkAGI3NDhlZmQzLWQxYjAtNGJjNy04NmYwLWQ0M2IzZTNlMDUwNAAuAAAAAACQ1l2jfH6VSZraktP8Z7auAQCbV93BagWITZhL3J6BMqhjAAD9pHIhAAA=_ to "My updated task list"
+Rename the list with a specific ID
 
 ```sh
 m365 todo list set --id "AAMkAGI3NDhlZmQzLWQxYjAtNGJjNy04NmYwLWQ0M2IzZTNlMDUwNAAuAAAAAACQ1l2jfH6VSZraktP8Z7auAQCbV93BagWITZhL3J6BMqhjAAD9pHIhAAA=" --newName "My updated task list"
 ```
 
-Rename the list with name _My Task list_ to "My updated task list"
+Rename a list with a specific title
 
 ```sh
 m365 todo list set --name "My Task list" --newName "My updated task list"
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/todo/task/task-add.md

@@ -11,26 +11,109 @@ m365 todo task add [options]
 ## Options
 
 `-t, --title <title>`
-: The title of the task
+: The title of the task.
 
 `--listName [listName]`
-: The name of the list in which to create the task. Specify either `listName` or `listId` but not both
+: The name of the list in which to create the task. Specify either `listName` or `listId`, but not both.
 
 `--listId [listId]`
-: The id of the list in which to create the task. Specify either `listName` or `listId` but not both
+: The id of the list in which to create the task. Specify either `listName` or `listId`, 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` and `html`. Default is `text`.
+
+`--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 is `normal`.
+
+`--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.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Add a task with title _New task_ to Microsoft To Do tasks list with the name _My task list_
+Add a task to Microsoft To Do tasks list with with a specific name
 
 ```sh
 m365 todo task add --title "New task" --listName "My task list"
 ```
 
-Add a task with title _New task_ to Microsoft To Do tasks list with the id `AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==`
+Add a task to a Microsoft To Do tasks list with a specific id
 
 ```sh
 m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA=="
 ```
+
+Create a new task with bodyContent and reminder and flag it as important
+
+```sh
+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
+
+```sh
+m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
+```
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    {
+      "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"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    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
+    ```
+
+=== "CSV"
+
+    ```csv
+    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""}"
+    ```

package/docs/docs/cmd/todo/task/task-get.md

@@ -0,0 +1,75 @@
+# todo task get
+
+Gets a specific task from a Microsoft To Do task list
+
+## Usage
+
+```sh
+m365 todo task get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The ID of the task in the list.
+
+`--listName [listName]`
+: The name of the task list to return tasks from. Specify either `listName` or `listId`, but not both.
+
+`--listId [listId]`
+: The id of the task list to return tasks from. Specify either `listName` or `listId`, but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Gets a specific task from a Microsoft To Do tasks list based on the name of the list and the task id
+
+```sh
+m365 todo task get --listName "My task list" --id "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA="
+```
+
+Gets a specific task from a Microsoft To Do tasks list based on the id of the list and the task id
+
+```sh
+m365 todo task get --listId "AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQABF-BAgwAAAA==" --id "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA="
+```
+
+## Response
+
+=== "JSON"
+
+    ``` json
+    {
+      "importance": "normal",
+      "isReminderOn": false,
+      "status": "notStarted",
+      "title": "Stay healthy",
+      "createdDateTime": "2022-10-23T14:05:09.2673009Z",
+      "lastModifiedDateTime": "2022-10-23T14:15:11.3180312Z",
+      "hasAttachments": false,
+      "categories": [],
+      "id": "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=",
+      "body": {
+        "content": "",
+        "contentType": "text"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ``` text
+    createdDateTime     : 2022-10-23T14:05:09.2673009Z
+    id                  : AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=
+    lastModifiedDateTime: 2022-10-23T14:15:11.3180312Z
+    status              : notStarted
+    title               : Stay healthy
+    ```
+
+=== "CSV"
+
+    ``` text
+    id,title,status,createdDateTime,lastModifiedDateTime
+    AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=,Stay healthy,notStarted,2022-10-23T14:05:09.2673009Z,2022-10-23T14:15:11.3180312Z
+    ```

package/docs/docs/cmd/todo/task/task-list.md

@@ -31,3 +31,50 @@ List tasks from Microsoft To Do tasks list with the id AQMkAGYzNjMxYTU4LTJjZjYtN
 ```sh
 m365 todo task list --listId "AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQABF-BAgwAAAA=="
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "importance": "high",
+        "isReminderOn": true,
+        "status": "notStarted",
+        "title": "New task",
+        "createdDateTime": "2022-10-29T11:03:20.9175176Z",
+        "lastModifiedDateTime": "2022-10-29T11:13:23.6672968Z",
+        "hasAttachments": false,
+        "categories": [],
+        "id": "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=",
+        "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"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                                                                                                                                        title           status      createdDateTime               lastModifiedDateTime
+    --------------------------------------------------------------------------------------------------------------------------------------------------------  --------------  ----------  ----------------------------  ----------------------------
+    AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=  New task        notStarted  2022-10-29T11:03:20.9175176Z  2022-10-29T11:13:23.6672968Z
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,title,status,createdDateTime,lastModifiedDateTime
+    AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=,New task,notStarted,2022-10-29T11:03:20.9175176Z,2022-10-29T11:13:23.6672968Z
+    ```

package/docs/docs/cmd/todo/task/task-remove.md

@@ -11,16 +11,16 @@ m365 todo task remove [options]
 ## Options
 
 `-i, --id <id>`
-: The id of the task to remove
+: The id of the task to remove.
 
 `--listName [listName]`
-: The name of the task list in which the task exists. Specify either `listId` or `listName`, not both
+: The name of the task list in which the task exists. Specify either `listId` or `listName`, but not both.
 
 `--listId [listId]`
-: The id of the task list in which the task exists. Specify either `listId` or `listName`, not both
+: The id of the task list in which the task exists. Specify either `listId` or `listName`, but not both.
 
 `--confirm`
-: Don't prompt for confirmation
+: Don't prompt for confirmation.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -37,3 +37,8 @@ Removes Microsoft To Do task with the specified id in a list with the specified
 ```sh
 m365 todo task remove --id "BBMkAGI3NDhlZmQzLWQxYjAtNGJjNy04NmYwLWQ0M2IzZTNlMDUwNAAuAAAAAACQ1l2jfH6VSZraktP8Z7auAQCbV93BagWITZhL3J6BMqhjAAD9pHIhBBB=" --listId "AAMkAGI3NDhlZmQzLWQxYjAtNGJjNy04NmYwLWQ0M2IzZTNlMDUwNAAuAAAAAACQ1l2jfH6VSZraktP8Z7auAQCbV93BagWITZhL3J6BMqhjAAD9pHIhAAA="
 ```
+
+## Response
+
+The command won't return a response on success.
+

package/docs/docs/cmd/todo/task/task-set.md

@@ -11,19 +11,19 @@ m365 todo task set [options]
 ## Options
 
 `-i, --id <id>`
-: The id of the task to update
+: The id of the task to update.
 
 `-t, --title [title]`
-: Sets the task title
+: Sets the task title.
 
 `-s, --status [status]`
-: Sets the status of the task. Allowed values `notStarted`,`inProgress`,`completed`,`waitingOnOthers`,`deferred`
+: Sets the status of the task. Allowed values are `notStarted`, `inProgress`, `completed`, `waitingOnOthers`, `deferred`.
 
 `--listName [listName]`
-: The name of the task list in which the task exists. Specify either `listName` or `listId`, not both
+: The name of the task list in which the task exists. Specify either `listName` or `listId`, but not both.
 
 `--listId [listId]`
-: The id of the task list in which the task exists. Specify either `listName` or `listId`, not both
+: The id of the task list in which the task exists. Specify either `listName` or `listId`, but not both.
 
 `--bodyContent [bodyContent]`
 : The body content of the task. In the UI this is called 'notes'.
@@ -67,3 +67,57 @@ Update a task with due date in Microsoft To Do tasks list with list id
 ```sh
 m365 todo task set --id "AAMkADU3Y2E0OTMxLTllYTQtNGFlZS1hZGM0LWI1NjZjY2FhM2RhMABGAAAAAADhr7P77n9xS6PdtDemRwpHBwCin1tvQMXzRKN1hQDz2S3VAAAXXsleAACin1tvQMXzRKN1hQDz2S3VAAAXXzr9AAA=" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "importance": "high",
+      "isReminderOn": true,
+      "status": "notStarted",
+      "title": "Update doco",
+      "createdDateTime": "2022-10-29T11:03:20.9175176Z",
+      "lastModifiedDateTime": "2022-10-30T14:07:03.0718199Z",
+      "hasAttachments": false,
+      "categories": [],
+      "id": "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=",
+      "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"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    body                : {"content":"I should not forget this","contentType":"text"}
+    categories          : []
+    createdDateTime     : 2022-10-29T11:03:20.9175176Z
+    dueDateTime         : {"dateTime":"2023-01-01T00:00:00.0000000","timeZone":"UTC"}
+    hasAttachments      : false
+    id                  : AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=
+    importance          : high
+    isReminderOn        : true
+    lastModifiedDateTime: 2022-10-30T14:08:17.6665299Z
+    reminderDateTime    : {"dateTime":"2023-01-01T12:00:00.0000000","timeZone":"UTC"}
+    status              : notStarted
+    title               : Update doco
+    ```
+
+=== "CSV"
+
+    ```csv
+    importance,isReminderOn,status,title,createdDateTime,lastModifiedDateTime,hasAttachments,categories,id,body,dueDateTime,reminderDateTime
+    high,1,notStarted,Update doco,2022-10-29T11:03:20.9175176Z,2022-10-30T14:09:14.7687057Z,,[],AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAL3xdLTAADEwEFouXWWT50CfwqSN9cpAAL3xhtSAAA=,"{""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""}"
+    ```