Update up to 100 tasks, each with its own values
curl --request POST \
--url https://api.statisfy.com/v1/objects/task/records/batch/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"id": "<string>",
"assignee": null,
"description": null,
"due_date": null,
"fields": {},
"priority": null,
"start_date": null,
"status": null,
"title": null
}
]
}
'import requests
url = "https://api.statisfy.com/v1/objects/task/records/batch/update"
payload = { "items": [
{
"id": "<string>",
"assignee": None,
"description": None,
"due_date": None,
"fields": {},
"priority": None,
"start_date": None,
"status": None,
"title": None
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
id: '<string>',
assignee: null,
description: null,
due_date: null,
fields: {},
priority: null,
start_date: null,
status: null,
title: null
}
]
})
};
fetch('https://api.statisfy.com/v1/objects/task/records/batch/update', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.statisfy.com/v1/objects/task/records/batch/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'id' => '<string>',
'assignee' => null,
'description' => null,
'due_date' => null,
'fields' => [
],
'priority' => null,
'start_date' => null,
'status' => null,
'title' => null
]
]
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.statisfy.com/v1/objects/task/records/batch/update"
payload := strings.NewReader("{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"priority\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.statisfy.com/v1/objects/task/records/batch/update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"priority\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/objects/task/records/batch/update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"priority\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "<string>",
"status": "updated",
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{}
]
}
}
]
}tasks
Update up to 100 tasks, each with its own values
items is up to 100 updates, each a task id and an update body; a task may appear once (twice is a 422 for the whole request). Each is checked and written on its own, as a single update is (its cascade and email included), so one failure does not stop the rest. The answer lists every item in request order with status updated or failed, and for a failure the error a single update would have returned; as with a single update, a failed item may have had its standard fields written. It counts as one write per item against your rate limit, so a batch larger than your per-minute limit is a 422.
POST
/
v1
/
objects
/
task
/
records
/
batch
/
update
Update up to 100 tasks, each with its own values
curl --request POST \
--url https://api.statisfy.com/v1/objects/task/records/batch/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"id": "<string>",
"assignee": null,
"description": null,
"due_date": null,
"fields": {},
"priority": null,
"start_date": null,
"status": null,
"title": null
}
]
}
'import requests
url = "https://api.statisfy.com/v1/objects/task/records/batch/update"
payload = { "items": [
{
"id": "<string>",
"assignee": None,
"description": None,
"due_date": None,
"fields": {},
"priority": None,
"start_date": None,
"status": None,
"title": None
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
id: '<string>',
assignee: null,
description: null,
due_date: null,
fields: {},
priority: null,
start_date: null,
status: null,
title: null
}
]
})
};
fetch('https://api.statisfy.com/v1/objects/task/records/batch/update', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.statisfy.com/v1/objects/task/records/batch/update",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'items' => [
[
'id' => '<string>',
'assignee' => null,
'description' => null,
'due_date' => null,
'fields' => [
],
'priority' => null,
'start_date' => null,
'status' => null,
'title' => null
]
]
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.statisfy.com/v1/objects/task/records/batch/update"
payload := strings.NewReader("{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"priority\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.statisfy.com/v1/objects/task/records/batch/update")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"priority\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/objects/task/records/batch/update")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"items\": [\n {\n \"id\": \"<string>\",\n \"assignee\": null,\n \"description\": null,\n \"due_date\": null,\n \"fields\": {},\n \"priority\": null,\n \"start_date\": null,\n \"status\": null,\n \"title\": null\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"items": [
{
"id": "<string>",
"status": "updated",
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{}
]
}
}
]
}Authorizations
An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.
Body
application/json
Was this page helpful?