curl --request PUT \
--url https://api.virtuoussoftware.com/api/Task/{id}/Status \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "Completed"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({status: 'Completed'})
};
fetch('https://api.virtuoussoftware.com/api/Task/{id}/Status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.virtuoussoftware.com/api/Task/{id}/Status"
payload = { "status": "Completed" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)using RestSharp;
var options = new RestClientOptions("https://api.virtuoussoftware.com/api/Task/{id}/Status");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"status\": \"Completed\"\n}", false);
var response = await client.PutAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.virtuoussoftware.com/api/Task/{id}/Status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'status' => 'Completed'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.put("https://api.virtuoussoftware.com/api/Task/{id}/Status")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"status\": \"Completed\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.virtuoussoftware.com/api/Task/{id}/Status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"status\": \"Completed\"\n}"
response = http.request(request)
puts response.read_bodyconst url = 'https://api.virtuoussoftware.com/api/Task/{id}/Status';
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({status: 'Completed'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"id": 5,
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship.",
"dueDateTime": "2026-10-20T15:00:00",
"dueDateTimeUtc": "2026-10-20T22:00:00",
"taskStatus": "Completed",
"taskStatusDisplayName": "Completed",
"resolutionDateTimeUtc": "2026-10-20T16:35:16.907",
"isResolved": true,
"isPastDue": false,
"contactId": 10,
"contact": "Jane Smith",
"contactUrl": "https://api.virtuoussoftware.com/api/Contact/10",
"createDateTimeUtc": "2026-10-13T16:35:16.907",
"modifiedDateTimeUtc": "2026-10-20T16:35:16.907",
"createdByUser": "Development Team",
"createdByAvatarUrl": null,
"modifiedByUser": "Development Team"
}{
"title": "One or more validation errors occurred.",
"status": 400,
"errors": {
"Status": [
"'Voided' is not a valid task status."
]
}
}{
"message": "Authorization has been denied for this request."
}{
"message": "Rate limit exceeded. Try again later."
}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.
curl --request PUT \
--url https://api.virtuoussoftware.com/api/Task/{id}/Status \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"status": "Completed"
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({status: 'Completed'})
};
fetch('https://api.virtuoussoftware.com/api/Task/{id}/Status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.virtuoussoftware.com/api/Task/{id}/Status"
payload = { "status": "Completed" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)using RestSharp;
var options = new RestClientOptions("https://api.virtuoussoftware.com/api/Task/{id}/Status");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"status\": \"Completed\"\n}", false);
var response = await client.PutAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.virtuoussoftware.com/api/Task/{id}/Status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'status' => 'Completed'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.put("https://api.virtuoussoftware.com/api/Task/{id}/Status")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"status\": \"Completed\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.virtuoussoftware.com/api/Task/{id}/Status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"status\": \"Completed\"\n}"
response = http.request(request)
puts response.read_bodyconst url = 'https://api.virtuoussoftware.com/api/Task/{id}/Status';
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({status: 'Completed'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"id": 5,
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship.",
"dueDateTime": "2026-10-20T15:00:00",
"dueDateTimeUtc": "2026-10-20T22:00:00",
"taskStatus": "Completed",
"taskStatusDisplayName": "Completed",
"resolutionDateTimeUtc": "2026-10-20T16:35:16.907",
"isResolved": true,
"isPastDue": false,
"contactId": 10,
"contact": "Jane Smith",
"contactUrl": "https://api.virtuoussoftware.com/api/Contact/10",
"createDateTimeUtc": "2026-10-13T16:35:16.907",
"modifiedDateTimeUtc": "2026-10-20T16:35:16.907",
"createdByUser": "Development Team",
"createdByAvatarUrl": null,
"modifiedByUser": "Development Team"
}{
"title": "One or more validation errors occurred.",
"status": 400,
"errors": {
"Status": [
"'Voided' is not a valid task status."
]
}
}{
"message": "Authorization has been denied for this request."
}{
"message": "Rate limit exceeded. Try again later."
}Authorizations
Body
Response
OK
Was this page helpful?