Update a Task
curl --request PUT \
--url https://api.virtuoussoftware.com/api/Task/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship and seating.",
"dueDateTime": "2026-10-22T15:00:00",
"contactId": 10,
"contactIndividualId": 22
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
taskType: 'General',
task: 'Call Jane about the spring gala',
description: 'Confirm her table sponsorship and seating.',
dueDateTime: '2026-10-22T15:00:00',
contactId: 10,
contactIndividualId: 22
})
};
fetch('https://api.virtuoussoftware.com/api/Task/{id}', 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}"
payload = {
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship and seating.",
"dueDateTime": "2026-10-22T15:00:00",
"contactId": 10,
"contactIndividualId": 22
}
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}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship and seating.\",\n \"dueDateTime\": \"2026-10-22T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\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}",
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([
'taskType' => 'General',
'task' => 'Call Jane about the spring gala',
'description' => 'Confirm her table sponsorship and seating.',
'dueDateTime' => '2026-10-22T15:00:00',
'contactId' => 10,
'contactIndividualId' => 22
]),
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}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship and seating.\",\n \"dueDateTime\": \"2026-10-22T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.virtuoussoftware.com/api/Task/{id}")
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 \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship and seating.\",\n \"dueDateTime\": \"2026-10-22T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}"
response = http.request(request)
puts response.read_bodyconst url = 'https://api.virtuoussoftware.com/api/Task/{id}';
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
taskType: 'General',
task: 'Call Jane about the spring gala',
description: 'Confirm her table sponsorship and seating.',
dueDateTime: '2026-10-22T15:00:00',
contactId: 10,
contactIndividualId: 22
})
};
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 and seating.",
"dueDateTime": "2026-10-22T15:00:00",
"dueDateTimeUtc": "2026-10-22T22:00:00",
"taskStatus": "InProgress",
"taskStatusDisplayName": "In Progress",
"taskKind": "Reminder",
"taskKindDisplayName": "Task",
"resolutionDateTimeUtc": null,
"isResolved": false,
"isPastDue": false,
"contactId": 10,
"contactIndividualId": 22,
"contact": "Jane Smith",
"contactUrl": "https://api.virtuoussoftware.com/api/Contact/10",
"createDateTimeUtc": "2026-10-13T16:35:16.907",
"modifiedDateTimeUtc": "2026-10-15T10:02:11.430",
"createdByUser": "Development Team",
"createdByAvatarUrl": null,
"modifiedByUser": "Development Team"
}{
"title": "One or more validation errors occurred.",
"status": 400,
"errors": {
"ContactId": [
"A contact is required when a contact individual is sent."
]
}
}{
"message": "Authorization has been denied for this request."
}{
"message": "Rate limit exceeded. Try again later."
}Tasks
Update a Task
Replaces a task’s type, title, description, due date, contact, and contact individual with the values you send, and returns the task in its resulting state. This is a full update: description, contactId, and contactIndividualId are cleared when you leave them out. The one exception is a task whose contact you can’t view. If you send no contactId for that task, its contact and contact individual are kept.
This endpoint doesn’t change the status or owner. Use Change a Task’s Status to change the status. Only tasks with a taskKind of Reminder can be updated, and a voided task can’t be updated. If two requests update the same task at once, the last one wins.
PUT
/
api
/
Task
/
{id}
Update a Task
curl --request PUT \
--url https://api.virtuoussoftware.com/api/Task/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship and seating.",
"dueDateTime": "2026-10-22T15:00:00",
"contactId": 10,
"contactIndividualId": 22
}
'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
taskType: 'General',
task: 'Call Jane about the spring gala',
description: 'Confirm her table sponsorship and seating.',
dueDateTime: '2026-10-22T15:00:00',
contactId: 10,
contactIndividualId: 22
})
};
fetch('https://api.virtuoussoftware.com/api/Task/{id}', 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}"
payload = {
"taskType": "General",
"task": "Call Jane about the spring gala",
"description": "Confirm her table sponsorship and seating.",
"dueDateTime": "2026-10-22T15:00:00",
"contactId": 10,
"contactIndividualId": 22
}
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}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship and seating.\",\n \"dueDateTime\": \"2026-10-22T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\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}",
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([
'taskType' => 'General',
'task' => 'Call Jane about the spring gala',
'description' => 'Confirm her table sponsorship and seating.',
'dueDateTime' => '2026-10-22T15:00:00',
'contactId' => 10,
'contactIndividualId' => 22
]),
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}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship and seating.\",\n \"dueDateTime\": \"2026-10-22T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.virtuoussoftware.com/api/Task/{id}")
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 \"taskType\": \"General\",\n \"task\": \"Call Jane about the spring gala\",\n \"description\": \"Confirm her table sponsorship and seating.\",\n \"dueDateTime\": \"2026-10-22T15:00:00\",\n \"contactId\": 10,\n \"contactIndividualId\": 22\n}"
response = http.request(request)
puts response.read_bodyconst url = 'https://api.virtuoussoftware.com/api/Task/{id}';
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
taskType: 'General',
task: 'Call Jane about the spring gala',
description: 'Confirm her table sponsorship and seating.',
dueDateTime: '2026-10-22T15:00:00',
contactId: 10,
contactIndividualId: 22
})
};
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 and seating.",
"dueDateTime": "2026-10-22T15:00:00",
"dueDateTimeUtc": "2026-10-22T22:00:00",
"taskStatus": "InProgress",
"taskStatusDisplayName": "In Progress",
"taskKind": "Reminder",
"taskKindDisplayName": "Task",
"resolutionDateTimeUtc": null,
"isResolved": false,
"isPastDue": false,
"contactId": 10,
"contactIndividualId": 22,
"contact": "Jane Smith",
"contactUrl": "https://api.virtuoussoftware.com/api/Contact/10",
"createDateTimeUtc": "2026-10-13T16:35:16.907",
"modifiedDateTimeUtc": "2026-10-15T10:02:11.430",
"createdByUser": "Development Team",
"createdByAvatarUrl": null,
"modifiedByUser": "Development Team"
}{
"title": "One or more validation errors occurred.",
"status": 400,
"errors": {
"ContactId": [
"A contact is required when a contact individual is sent."
]
}
}{
"message": "Authorization has been denied for this request."
}{
"message": "Rate limit exceeded. Try again later."
}Authorizations
Body
application/json
Response
OK
Last modified on November 4, 2026
Was this page helpful?