🔧 New: User Management Graph PowerShell Toolkit

Simplify user tasks like bulk creation, updates, password resets, deletions, license checks & more — all from one place.

🚀 Launch Toolkit

M365 PowerShell

How to Use Remove-MgUserTodoListTask in Graph PowerShell

The Remove-MgUserTodoListTask cmdlet is a powerful Microsoft Graph PowerShell command that allows administrators to delete tasks from a user’s To-Do task list. Whether you are managing tasks for a single user, multiple users, or performing bulk operations using CSV files, this cmdlet simplifies task removal operations.

In this article, we’ll explore its syntax, usage examples, tips, potential errors with solutions, use cases, and a conclusion.

Cmdlet Syntax

Remove-MgUserTodoListTask -UserId <String> -TodoTaskListId <String> -TodoTaskId <String>

Required Parameters:

-UserId: Specifies user’s unique identifier (e.g., User Principal Name or Object ID).
-TodoTaskListId: The unique ID of the To-Do task list.
-TodoTaskId: The unique ID of the task to remove.

Usage Examples

Example 1: Removing a Single Task

This example removes a specific task from a user's To-Do task list.

Remove-MgUserTodoListTask -UserId "john.doe@contoso.com" -TodoTaskListId "A1B2C3D4E5F6" -TodoTaskId "12345"

Example 2: Removing Multiple Tasks

If you have a list of tasks to delete, you can loop through them using PowerShell.

$tasksToRemove = @(
    @{ TodoTaskListId = "A1B2C3D4E5F6"; TodoTaskId = "12345" },
    @{ TodoTaskListId = "A1B2C3D4E5F6"; TodoTaskId = "67890" }
)

foreach ($task in $tasksToRemove) {
    Remove-MgUserTodoListTask -UserId "john.doe@contoso.com" -TodoTaskListId $task.TodoTaskListId -TodoTaskId $task.TodoTaskId
}

Example 3: Bulk Removal via CSV

To perform bulk deletions, create a CSV file (e.g., tasks.csv) with columns UserId, TodoTaskListId, and TodoTaskId. Loop through the file details and feed them to Remove-MgUserToDoListTask.


    UserId,TodoTaskListId,TodoTaskId
    john.doe@contoso.com,A1B2C3D4E5F6,12345
    jane.doe@contoso.com,A1B2C3D4E5F6,67890

$tasks = Import-Csv -Path "tasks.csv"
foreach ($task in $tasks) {
    Remove-MgUserTodoListTask -UserId $task.UserId -TodoTaskListId $task.TodoTaskListId -TodoTaskId $task.TodoTaskId
}

Tips for Using Remove-MgUserTodoListTask

Retrieve TodoTaskListId and TodoTaskId: Use Get-MgUserTodoList to fetch TodoTaskListId, and Get-MgUserTodoTask to fetch TodoTaskId.

Simulate with -WhatIf: Add -WhatIf to simulate task deletion and confirm tasks before deletion.
Validate Bulk Data: Before executing bulk operations, validate CSV data to ensure accuracy.

Possible Errors and Solutions

Error	Cause	Solution
User Not Found	Incorrect or non-existent UserId.	Verify the user exists and that the UserId is correct.
Task List Not Found	Invalid TodoTaskListId.	Use `Get-MgUserTodoList` to confirm the correct TodoTaskListId.
Task Not Found	The specified TodoTaskId does not exist.	Retrieve tasks using `Get-MgUserTodoTask` to confirm the TodoTaskId.
Insufficient Permissions	Lack of necessary Graph API permissions.	Ensure the account has the required Tasks.ReadWrite permissions.

Use Cases

Streamlining Task Management: Remove obsolete or completed tasks from users’ To-Do lists to maintain clarity and focus.
Automated Cleanup: Automate regular clean-up of tasks across multiple users to enhance organizational productivity.
Bulk Task Deletion: Remove project-specific tasks once the project is completed.
Task Delegation: Clear tasks from one user’s list before assigning them to another team member.

Frequently Asked Questions

Can I delete multiple tasks at once using Remove-MgUserTodoListTask?

No, the cmdlet only supports deletion of one task at a time. To delete multiple tasks, you must iterate over a list of task IDs and run the command individually for each task.

What happens if I try to delete a task that doesn’t exist?

You will receive a 404 Not Found error. This usually means the task ID is incorrect or the task has already been deleted.

Will deleting a task remove it from the user's task history?

Yes, once deleted using Remove-MgUserTodoListTask, the task is permanently removed from the user’s to-do list and is not recoverable via the Graph API.

Do I need special permissions to use Remove-MgUserTodoListTask?

Yes, the required permission is Tasks.ReadWrite. Make sure your app or user token has the appropriate delegated or application permission granted and consented.

📊 Deletion Doesn’t Affect Completed Task Records in Reports

Removing a to-do task using Remove-MgUserTodoListTask deletes it from the user's list, but it doesn't impact historical task reports or activity logs if you're tracking task completion externally via reporting systems.

🔁 Bulk Deletion Requires Iteration

Microsoft Graph doesn’t support bulk task deletion in a single call. To delete multiple tasks, loop through their task IDs and run Remove-MgUserTodoListTask for each one individually.

Conclusion

The Remove-MgUserTodoListTask cmdlet is an essential tool for administrators managing tasks in Microsoft 365. Whether you need to delete tasks for a single user, multiple users, or through bulk operations, this cmdlet simplifies the process. By combining it with other Graph PowerShell cmdlets like Get-MgUserTodoList and Get-MgUserTodoTask, administrators can efficiently manage To-Do tasks across the organization.