Create a new task
curl --request POST \
--url https://app.tarefy.com/nodeapi/v2/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Document task creation",
"initialDescription": {
"format": "quill-delta-v1",
"ops": [
{
"insert": "Add request fields, response schema, and examples for POST /v2/tasks."
},
{
"insert": "\n"
}
]
},
"client_id": 42,
"responsible_id": 17,
"project_id": 8,
"column_id": 31,
"due_date": "2026-05-20T18:00:00.000Z",
"start_date": "2026-05-19T12:00:00.000Z",
"urgency": "Alta",
"estimated_time": "008:00",
"budget": "012:00",
"type_id": 5,
"contract_id": 19,
"competence": 202605,
"tagsSelect": 3813,
"task_followers": [
{
"user": 21
},
{
"user": 24
}
],
"task_tags": [
{
"tag": 8
},
{
"tag": 13
}
],
"task_responsible": [
{
"user": 17
},
{
"user": 29
}
],
"custom_fields_value": [
{
"uuid": "cf_priority",
"value": "High"
},
{
"uuid": "cf_story_points",
"value": 5
}
]
}
'import requests
url = "https://app.tarefy.com/nodeapi/v2/tasks"
payload = {
"title": "Document task creation",
"initialDescription": {
"format": "quill-delta-v1",
"ops": [{ "insert": "Add request fields, response schema, and examples for POST /v2/tasks." }, { "insert": "
" }]
},
"client_id": 42,
"responsible_id": 17,
"project_id": 8,
"column_id": 31,
"due_date": "2026-05-20T18:00:00.000Z",
"start_date": "2026-05-19T12:00:00.000Z",
"urgency": "Alta",
"estimated_time": "008:00",
"budget": "012:00",
"type_id": 5,
"contract_id": 19,
"competence": 202605,
"tagsSelect": 3813,
"task_followers": [{ "user": 21 }, { "user": 24 }],
"task_tags": [{ "tag": 8 }, { "tag": 13 }],
"task_responsible": [{ "user": 17 }, { "user": 29 }],
"custom_fields_value": [
{
"uuid": "cf_priority",
"value": "High"
},
{
"uuid": "cf_story_points",
"value": 5
}
]
}
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({
title: 'Document task creation',
initialDescription: {
format: 'quill-delta-v1',
ops: [
{
insert: 'Add request fields, response schema, and examples for POST /v2/tasks.'
},
{insert: '\n'}
]
},
client_id: 42,
responsible_id: 17,
project_id: 8,
column_id: 31,
due_date: '2026-05-20T18:00:00.000Z',
start_date: '2026-05-19T12:00:00.000Z',
urgency: 'Alta',
estimated_time: '008:00',
budget: '012:00',
type_id: 5,
contract_id: 19,
competence: 202605,
tagsSelect: 3813,
task_followers: [{user: 21}, {user: 24}],
task_tags: [{tag: 8}, {tag: 13}],
task_responsible: [{user: 17}, {user: 29}],
custom_fields_value: [{uuid: 'cf_priority', value: 'High'}, {uuid: 'cf_story_points', value: 5}]
})
};
fetch('https://app.tarefy.com/nodeapi/v2/tasks', 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://app.tarefy.com/nodeapi/v2/tasks",
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([
'title' => 'Document task creation',
'initialDescription' => [
'format' => 'quill-delta-v1',
'ops' => [
[
'insert' => 'Add request fields, response schema, and examples for POST /v2/tasks.'
],
[
'insert' => '
'
]
]
],
'client_id' => 42,
'responsible_id' => 17,
'project_id' => 8,
'column_id' => 31,
'due_date' => '2026-05-20T18:00:00.000Z',
'start_date' => '2026-05-19T12:00:00.000Z',
'urgency' => 'Alta',
'estimated_time' => '008:00',
'budget' => '012:00',
'type_id' => 5,
'contract_id' => 19,
'competence' => 202605,
'tagsSelect' => 3813,
'task_followers' => [
[
'user' => 21
],
[
'user' => 24
]
],
'task_tags' => [
[
'tag' => 8
],
[
'tag' => 13
]
],
'task_responsible' => [
[
'user' => 17
],
[
'user' => 29
]
],
'custom_fields_value' => [
[
'uuid' => 'cf_priority',
'value' => 'High'
],
[
'uuid' => 'cf_story_points',
'value' => 5
]
]
]),
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://app.tarefy.com/nodeapi/v2/tasks"
payload := strings.NewReader("{\n \"title\": \"Document task creation\",\n \"initialDescription\": {\n \"format\": \"quill-delta-v1\",\n \"ops\": [\n {\n \"insert\": \"Add request fields, response schema, and examples for POST /v2/tasks.\"\n },\n {\n \"insert\": \"\\n\"\n }\n ]\n },\n \"client_id\": 42,\n \"responsible_id\": 17,\n \"project_id\": 8,\n \"column_id\": 31,\n \"due_date\": \"2026-05-20T18:00:00.000Z\",\n \"start_date\": \"2026-05-19T12:00:00.000Z\",\n \"urgency\": \"Alta\",\n \"estimated_time\": \"008:00\",\n \"budget\": \"012:00\",\n \"type_id\": 5,\n \"contract_id\": 19,\n \"competence\": 202605,\n \"tagsSelect\": 3813,\n \"task_followers\": [\n {\n \"user\": 21\n },\n {\n \"user\": 24\n }\n ],\n \"task_tags\": [\n {\n \"tag\": 8\n },\n {\n \"tag\": 13\n }\n ],\n \"task_responsible\": [\n {\n \"user\": 17\n },\n {\n \"user\": 29\n }\n ],\n \"custom_fields_value\": [\n {\n \"uuid\": \"cf_priority\",\n \"value\": \"High\"\n },\n {\n \"uuid\": \"cf_story_points\",\n \"value\": 5\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://app.tarefy.com/nodeapi/v2/tasks")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Document task creation\",\n \"initialDescription\": {\n \"format\": \"quill-delta-v1\",\n \"ops\": [\n {\n \"insert\": \"Add request fields, response schema, and examples for POST /v2/tasks.\"\n },\n {\n \"insert\": \"\\n\"\n }\n ]\n },\n \"client_id\": 42,\n \"responsible_id\": 17,\n \"project_id\": 8,\n \"column_id\": 31,\n \"due_date\": \"2026-05-20T18:00:00.000Z\",\n \"start_date\": \"2026-05-19T12:00:00.000Z\",\n \"urgency\": \"Alta\",\n \"estimated_time\": \"008:00\",\n \"budget\": \"012:00\",\n \"type_id\": 5,\n \"contract_id\": 19,\n \"competence\": 202605,\n \"tagsSelect\": 3813,\n \"task_followers\": [\n {\n \"user\": 21\n },\n {\n \"user\": 24\n }\n ],\n \"task_tags\": [\n {\n \"tag\": 8\n },\n {\n \"tag\": 13\n }\n ],\n \"task_responsible\": [\n {\n \"user\": 17\n },\n {\n \"user\": 29\n }\n ],\n \"custom_fields_value\": [\n {\n \"uuid\": \"cf_priority\",\n \"value\": \"High\"\n },\n {\n \"uuid\": \"cf_story_points\",\n \"value\": 5\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.tarefy.com/nodeapi/v2/tasks")
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 \"title\": \"Document task creation\",\n \"initialDescription\": {\n \"format\": \"quill-delta-v1\",\n \"ops\": [\n {\n \"insert\": \"Add request fields, response schema, and examples for POST /v2/tasks.\"\n },\n {\n \"insert\": \"\\n\"\n }\n ]\n },\n \"client_id\": 42,\n \"responsible_id\": 17,\n \"project_id\": 8,\n \"column_id\": 31,\n \"due_date\": \"2026-05-20T18:00:00.000Z\",\n \"start_date\": \"2026-05-19T12:00:00.000Z\",\n \"urgency\": \"Alta\",\n \"estimated_time\": \"008:00\",\n \"budget\": \"012:00\",\n \"type_id\": 5,\n \"contract_id\": 19,\n \"competence\": 202605,\n \"tagsSelect\": 3813,\n \"task_followers\": [\n {\n \"user\": 21\n },\n {\n \"user\": 24\n }\n ],\n \"task_tags\": [\n {\n \"tag\": 8\n },\n {\n \"tag\": 13\n }\n ],\n \"task_responsible\": [\n {\n \"user\": 17\n },\n {\n \"user\": 29\n }\n ],\n \"custom_fields_value\": [\n {\n \"uuid\": \"cf_priority\",\n \"value\": \"High\"\n },\n {\n \"uuid\": \"cf_story_points\",\n \"value\": 5\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": 1532,
"task_id": 1532,
"title": "Document task creation",
"description": "Add request fields, response schema, and examples for POST /v2/tasks.",
"checklist": "{\"groups\":[{\"id\":1,\"name\":\"Checklist\",\"items\":[{\"id\":2,\"name\":\"Validate payload\",\"checked\":false}]}]}",
"status": 0,
"due_date": "2026-05-20T18:00:00.000Z",
"start_date": "2026-05-19T12:00:00.000Z",
"end_date": null,
"created_at": "2026-05-19T13:40:00.000Z",
"updated_at": "2026-05-19T13:40:00.000Z",
"finished_at": null,
"urgency": "Alta",
"bug": false,
"estimated_time": "008:00",
"worked_time": "000:00",
"budget": "012:00",
"type_id": 5,
"contract_id": 19,
"contract_service_id": null,
"parent_task_id": null,
"project_id": 8,
"project_name": "API Documentation",
"column_id": 31,
"column_name": "Backlog",
"client": {
"id": 42,
"name": "Acme Ltda",
"cnpj": "12.345.678/0001-90",
"cpf": null
},
"responsibles": [
{
"id": 17,
"name": "Ana Silva",
"isDelivered": false,
"deliveredAt": null
},
{
"id": 29,
"name": "Bruno Costa",
"isDelivered": false,
"deliveredAt": null
}
],
"tags": [
{
"id": 8,
"name": "API"
},
{
"id": 13,
"name": "Documentation"
}
]
}{
"code": "TASK_REQUIRED_FIELDS_MISSING",
"message": "Preencha os campos obrigatórios para criar a tarefa.",
"missingFields": [
"competence"
],
"statusCode": 400
}Tasks
Create a new task
Creates a task in the authenticated account. If project_id is provided without column_id, the API automatically uses the first column in the project. The internal DTO contains created_at and is_closed, but this route does not apply those fields.
POST
/
v2
/
tasks
Create a new task
curl --request POST \
--url https://app.tarefy.com/nodeapi/v2/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Document task creation",
"initialDescription": {
"format": "quill-delta-v1",
"ops": [
{
"insert": "Add request fields, response schema, and examples for POST /v2/tasks."
},
{
"insert": "\n"
}
]
},
"client_id": 42,
"responsible_id": 17,
"project_id": 8,
"column_id": 31,
"due_date": "2026-05-20T18:00:00.000Z",
"start_date": "2026-05-19T12:00:00.000Z",
"urgency": "Alta",
"estimated_time": "008:00",
"budget": "012:00",
"type_id": 5,
"contract_id": 19,
"competence": 202605,
"tagsSelect": 3813,
"task_followers": [
{
"user": 21
},
{
"user": 24
}
],
"task_tags": [
{
"tag": 8
},
{
"tag": 13
}
],
"task_responsible": [
{
"user": 17
},
{
"user": 29
}
],
"custom_fields_value": [
{
"uuid": "cf_priority",
"value": "High"
},
{
"uuid": "cf_story_points",
"value": 5
}
]
}
'import requests
url = "https://app.tarefy.com/nodeapi/v2/tasks"
payload = {
"title": "Document task creation",
"initialDescription": {
"format": "quill-delta-v1",
"ops": [{ "insert": "Add request fields, response schema, and examples for POST /v2/tasks." }, { "insert": "
" }]
},
"client_id": 42,
"responsible_id": 17,
"project_id": 8,
"column_id": 31,
"due_date": "2026-05-20T18:00:00.000Z",
"start_date": "2026-05-19T12:00:00.000Z",
"urgency": "Alta",
"estimated_time": "008:00",
"budget": "012:00",
"type_id": 5,
"contract_id": 19,
"competence": 202605,
"tagsSelect": 3813,
"task_followers": [{ "user": 21 }, { "user": 24 }],
"task_tags": [{ "tag": 8 }, { "tag": 13 }],
"task_responsible": [{ "user": 17 }, { "user": 29 }],
"custom_fields_value": [
{
"uuid": "cf_priority",
"value": "High"
},
{
"uuid": "cf_story_points",
"value": 5
}
]
}
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({
title: 'Document task creation',
initialDescription: {
format: 'quill-delta-v1',
ops: [
{
insert: 'Add request fields, response schema, and examples for POST /v2/tasks.'
},
{insert: '\n'}
]
},
client_id: 42,
responsible_id: 17,
project_id: 8,
column_id: 31,
due_date: '2026-05-20T18:00:00.000Z',
start_date: '2026-05-19T12:00:00.000Z',
urgency: 'Alta',
estimated_time: '008:00',
budget: '012:00',
type_id: 5,
contract_id: 19,
competence: 202605,
tagsSelect: 3813,
task_followers: [{user: 21}, {user: 24}],
task_tags: [{tag: 8}, {tag: 13}],
task_responsible: [{user: 17}, {user: 29}],
custom_fields_value: [{uuid: 'cf_priority', value: 'High'}, {uuid: 'cf_story_points', value: 5}]
})
};
fetch('https://app.tarefy.com/nodeapi/v2/tasks', 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://app.tarefy.com/nodeapi/v2/tasks",
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([
'title' => 'Document task creation',
'initialDescription' => [
'format' => 'quill-delta-v1',
'ops' => [
[
'insert' => 'Add request fields, response schema, and examples for POST /v2/tasks.'
],
[
'insert' => '
'
]
]
],
'client_id' => 42,
'responsible_id' => 17,
'project_id' => 8,
'column_id' => 31,
'due_date' => '2026-05-20T18:00:00.000Z',
'start_date' => '2026-05-19T12:00:00.000Z',
'urgency' => 'Alta',
'estimated_time' => '008:00',
'budget' => '012:00',
'type_id' => 5,
'contract_id' => 19,
'competence' => 202605,
'tagsSelect' => 3813,
'task_followers' => [
[
'user' => 21
],
[
'user' => 24
]
],
'task_tags' => [
[
'tag' => 8
],
[
'tag' => 13
]
],
'task_responsible' => [
[
'user' => 17
],
[
'user' => 29
]
],
'custom_fields_value' => [
[
'uuid' => 'cf_priority',
'value' => 'High'
],
[
'uuid' => 'cf_story_points',
'value' => 5
]
]
]),
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://app.tarefy.com/nodeapi/v2/tasks"
payload := strings.NewReader("{\n \"title\": \"Document task creation\",\n \"initialDescription\": {\n \"format\": \"quill-delta-v1\",\n \"ops\": [\n {\n \"insert\": \"Add request fields, response schema, and examples for POST /v2/tasks.\"\n },\n {\n \"insert\": \"\\n\"\n }\n ]\n },\n \"client_id\": 42,\n \"responsible_id\": 17,\n \"project_id\": 8,\n \"column_id\": 31,\n \"due_date\": \"2026-05-20T18:00:00.000Z\",\n \"start_date\": \"2026-05-19T12:00:00.000Z\",\n \"urgency\": \"Alta\",\n \"estimated_time\": \"008:00\",\n \"budget\": \"012:00\",\n \"type_id\": 5,\n \"contract_id\": 19,\n \"competence\": 202605,\n \"tagsSelect\": 3813,\n \"task_followers\": [\n {\n \"user\": 21\n },\n {\n \"user\": 24\n }\n ],\n \"task_tags\": [\n {\n \"tag\": 8\n },\n {\n \"tag\": 13\n }\n ],\n \"task_responsible\": [\n {\n \"user\": 17\n },\n {\n \"user\": 29\n }\n ],\n \"custom_fields_value\": [\n {\n \"uuid\": \"cf_priority\",\n \"value\": \"High\"\n },\n {\n \"uuid\": \"cf_story_points\",\n \"value\": 5\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://app.tarefy.com/nodeapi/v2/tasks")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Document task creation\",\n \"initialDescription\": {\n \"format\": \"quill-delta-v1\",\n \"ops\": [\n {\n \"insert\": \"Add request fields, response schema, and examples for POST /v2/tasks.\"\n },\n {\n \"insert\": \"\\n\"\n }\n ]\n },\n \"client_id\": 42,\n \"responsible_id\": 17,\n \"project_id\": 8,\n \"column_id\": 31,\n \"due_date\": \"2026-05-20T18:00:00.000Z\",\n \"start_date\": \"2026-05-19T12:00:00.000Z\",\n \"urgency\": \"Alta\",\n \"estimated_time\": \"008:00\",\n \"budget\": \"012:00\",\n \"type_id\": 5,\n \"contract_id\": 19,\n \"competence\": 202605,\n \"tagsSelect\": 3813,\n \"task_followers\": [\n {\n \"user\": 21\n },\n {\n \"user\": 24\n }\n ],\n \"task_tags\": [\n {\n \"tag\": 8\n },\n {\n \"tag\": 13\n }\n ],\n \"task_responsible\": [\n {\n \"user\": 17\n },\n {\n \"user\": 29\n }\n ],\n \"custom_fields_value\": [\n {\n \"uuid\": \"cf_priority\",\n \"value\": \"High\"\n },\n {\n \"uuid\": \"cf_story_points\",\n \"value\": 5\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.tarefy.com/nodeapi/v2/tasks")
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 \"title\": \"Document task creation\",\n \"initialDescription\": {\n \"format\": \"quill-delta-v1\",\n \"ops\": [\n {\n \"insert\": \"Add request fields, response schema, and examples for POST /v2/tasks.\"\n },\n {\n \"insert\": \"\\n\"\n }\n ]\n },\n \"client_id\": 42,\n \"responsible_id\": 17,\n \"project_id\": 8,\n \"column_id\": 31,\n \"due_date\": \"2026-05-20T18:00:00.000Z\",\n \"start_date\": \"2026-05-19T12:00:00.000Z\",\n \"urgency\": \"Alta\",\n \"estimated_time\": \"008:00\",\n \"budget\": \"012:00\",\n \"type_id\": 5,\n \"contract_id\": 19,\n \"competence\": 202605,\n \"tagsSelect\": 3813,\n \"task_followers\": [\n {\n \"user\": 21\n },\n {\n \"user\": 24\n }\n ],\n \"task_tags\": [\n {\n \"tag\": 8\n },\n {\n \"tag\": 13\n }\n ],\n \"task_responsible\": [\n {\n \"user\": 17\n },\n {\n \"user\": 29\n }\n ],\n \"custom_fields_value\": [\n {\n \"uuid\": \"cf_priority\",\n \"value\": \"High\"\n },\n {\n \"uuid\": \"cf_story_points\",\n \"value\": 5\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"id": 1532,
"task_id": 1532,
"title": "Document task creation",
"description": "Add request fields, response schema, and examples for POST /v2/tasks.",
"checklist": "{\"groups\":[{\"id\":1,\"name\":\"Checklist\",\"items\":[{\"id\":2,\"name\":\"Validate payload\",\"checked\":false}]}]}",
"status": 0,
"due_date": "2026-05-20T18:00:00.000Z",
"start_date": "2026-05-19T12:00:00.000Z",
"end_date": null,
"created_at": "2026-05-19T13:40:00.000Z",
"updated_at": "2026-05-19T13:40:00.000Z",
"finished_at": null,
"urgency": "Alta",
"bug": false,
"estimated_time": "008:00",
"worked_time": "000:00",
"budget": "012:00",
"type_id": 5,
"contract_id": 19,
"contract_service_id": null,
"parent_task_id": null,
"project_id": 8,
"project_name": "API Documentation",
"column_id": 31,
"column_name": "Backlog",
"client": {
"id": 42,
"name": "Acme Ltda",
"cnpj": "12.345.678/0001-90",
"cpf": null
},
"responsibles": [
{
"id": 17,
"name": "Ana Silva",
"isDelivered": false,
"deliveredAt": null
},
{
"id": 29,
"name": "Bruno Costa",
"isDelivered": false,
"deliveredAt": null
}
],
"tags": [
{
"id": 8,
"name": "API"
},
{
"id": 13,
"name": "Documentation"
}
]
}{
"code": "TASK_REQUIRED_FIELDS_MISSING",
"message": "Preencha os campos obrigatórios para criar a tarefa.",
"missingFields": [
"competence"
],
"statusCode": 400
}Authorizations
JWT token obtained from /v2/auth/login. Send it in the header:
Authorization: Bearer <your_token>
Body
application/json
Title shown on the task card.
Example:
"Document task creation"
Legacy HTML/text description accepted only for compatibility with integrations. New clients must use initialDescription.
Example:
"Add request fields, response schema, and examples for POST /v2/tasks."
Authoritative first task description. New Task clients must send this Quill Delta contract so the task opens without legacy migration.
Show child attributes
Show child attributes
Client ID linked to the task. It must belong to the authenticated account.
Example:
42
Primary responsible user ID.
Example:
17
Desired due date in ISO 8601 format.
Example:
"2026-05-20T18:00:00.000Z"
Planned start date in ISO 8601 format.
Example:
"2026-05-19T12:00:00.000Z"
Completion timestamp in ISO 8601 format.
Example:
"2026-05-21T21:30:00.000Z"
Planned end date in ISO 8601 format.
Example:
"2026-05-30T18:00:00.000Z"
Numeric task status. When omitted, the API uses 0.
Example:
0
Urgency label. When omitted, the API uses the raw value Baixa.
Example:
"Alta"
Estimated effort in HHH:MM format.
Example:
"008:00"
Budgeted effort in HHH:MM format.
Example:
"012:00"
Project ID for the task.
Example:
8
Column ID where the task should be created. If omitted with project_id, the API uses the first project column.
Example:
31
Competence (reference month) of the task as an integer in YYYYMM format, e.g. 202610 for October 2026. Required when the account or project marks the Competence field as required in the task creation settings.
Example:
202605
Task type ID.
Example:
5
Related contract ID.
Example:
19
Parent task ID. When provided, the new task is created as a subtask.
Example:
1201
Marks the task as a bug.
Example:
false
Legacy raw tags field persisted on the task record.
Example:
"fiscal,api"
Comma-separated tag IDs used to create task_tags relationships.
Example:
3813
Full checklist document serialized as a JSON string. Use the grouped groups format used by TaskView.
Example:
"{\"groups\":[{\"id\":1,\"name\":\"Checklist\",\"items\":[{\"id\":2,\"name\":\"Validate payload\",\"checked\":false}]}]}"
ID of the received form that originated the task.
Example:
77
Explicit task followers.
Show child attributes
Show child attributes
Tags to be attached to the task.
Show child attributes
Show child attributes
Additional responsible users. During creation, the API uses the user field to create the relationships.
Show child attributes
Show child attributes
Custom field values. Each item must include uuid and value.
Show child attributes
Show child attributes
Response
Task created successfully
Internal task ID.
Example:
1532
Public numeric task identifier.
Example:
1532
Example:
"Document task creation"
Example:
"Add request fields, response schema, and examples for POST /v2/tasks."
Full checklist document serialized as a JSON string. The value is null when no checklist exists.
Example:
"{\"groups\":[{\"id\":1,\"name\":\"Checklist\",\"items\":[{\"id\":2,\"name\":\"Validate payload\",\"checked\":false}]}]}"
Example:
0
Example:
"2026-05-20T18:00:00.000Z"
Example:
null
Example:
"2026-05-19T12:00:00.000Z"
Example:
null
Example:
"Alta"
Example:
false
Example:
"008:00"
Example:
"000:00"
Example:
"012:00"
Example:
5
Example:
19
Example:
null
Example:
null
Example:
8
Example:
"API Documentation"
Example:
31
Example:
"Backlog"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes