> ## Documentation Index
> Fetch the complete documentation index at: https://docs.virtuous.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Change a Task's Status

> Completes, dismisses, or reopens a task, and returns the task in its resulting state. Send the new status as `status`. The value is not case sensitive and can be the status name (`NotStarted`, `InProgress`, `Blocked`, `Completed`, `Dismissed`), its display name (for example `In Progress`), its number (0 to 4), or one of the aliases `Upcoming`, `In-progress`, `Complete`, `Done`, and `Finished`.

Completing or dismissing a task sets `resolutionDateTimeUtc`. Moving it back to Not Started, In Progress, or Blocked clears it. Sending the status the task already has changes nothing and returns `200`. Completing a task that an administrator assigned sends that administrator the same completion email as completing it in Virtuous.

You can't set a task to `Voided`, and you can't change the status of a voided task. If two requests change the same task at once, the last one wins.



## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.virtuous.org/llms.txt).


## Related topics

- [Change a Task's Status](https://docs.virtuous.org/api-reference/tasks/change-a-tasks-status.md)
- [Update a Task](https://docs.virtuous.org/api-reference/tasks/update-a-task.md)
- [CRM+ Changelog](https://docs.virtuous.org/changelog/crm.md)
- [Create a Task](https://docs.virtuous.org/api-reference/tasks/create-a-task.md)
