Create a task
curl --request POST \
--url https://api.doers.sh/v2/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"areaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversationPath": "<string>",
"deadline": "2023-12-25",
"durationMin": 727,
"headingId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notes": "<string>",
"order": 123,
"priority": 2,
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"repeat": {
"every": 183,
"weekdays": [
4
]
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tags": [
"<string>"
],
"time": "<string>"
}
'import requests
url = "https://api.doers.sh/v2/tasks"
payload = {
"title": "<string>",
"areaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversationPath": "<string>",
"deadline": "2023-12-25",
"durationMin": 727,
"headingId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notes": "<string>",
"order": 123,
"priority": 2,
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"repeat": {
"every": 183,
"weekdays": [4]
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tags": ["<string>"],
"time": "<string>"
}
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: '<string>',
areaId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
conversationPath: '<string>',
deadline: '2023-12-25',
durationMin: 727,
headingId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
notes: '<string>',
order: 123,
priority: 2,
projectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
repeat: {every: 183, weekdays: [4]},
requestId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
tags: ['<string>'],
time: '<string>'
})
};
fetch('https://api.doers.sh/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://api.doers.sh/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' => '<string>',
'areaId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'conversationPath' => '<string>',
'deadline' => '2023-12-25',
'durationMin' => 727,
'headingId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'notes' => '<string>',
'order' => 123,
'priority' => 2,
'projectId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'repeat' => [
'every' => 183,
'weekdays' => [
4
]
],
'requestId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'tags' => [
'<string>'
],
'time' => '<string>'
]),
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.doers.sh/v2/tasks"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"areaId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"conversationPath\": \"<string>\",\n \"deadline\": \"2023-12-25\",\n \"durationMin\": 727,\n \"headingId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"notes\": \"<string>\",\n \"order\": 123,\n \"priority\": 2,\n \"projectId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"repeat\": {\n \"every\": 183,\n \"weekdays\": [\n 4\n ]\n },\n \"requestId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tags\": [\n \"<string>\"\n ],\n \"time\": \"<string>\"\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.doers.sh/v2/tasks")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"areaId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"conversationPath\": \"<string>\",\n \"deadline\": \"2023-12-25\",\n \"durationMin\": 727,\n \"headingId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"notes\": \"<string>\",\n \"order\": 123,\n \"priority\": 2,\n \"projectId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"repeat\": {\n \"every\": 183,\n \"weekdays\": [\n 4\n ]\n },\n \"requestId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tags\": [\n \"<string>\"\n ],\n \"time\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.doers.sh/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\": \"<string>\",\n \"areaId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"conversationPath\": \"<string>\",\n \"deadline\": \"2023-12-25\",\n \"durationMin\": 727,\n \"headingId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"notes\": \"<string>\",\n \"order\": 123,\n \"priority\": 2,\n \"projectId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"repeat\": {\n \"every\": 183,\n \"weekdays\": [\n 4\n ]\n },\n \"requestId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tags\": [\n \"<string>\"\n ],\n \"time\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"task": {
"id": "<string>",
"title": "<string>",
"notes": "<string>",
"status": "open",
"priority": 0,
"when": {
"kind": "today"
},
"deadline": "<string>",
"projectId": "<string>",
"areaId": "<string>",
"headingId": "<string>",
"tags": [
"<string>"
],
"checklist": [
{
"id": "<string>",
"label": "<string>",
"done": true
}
],
"completedAt": 123,
"durationMin": 123,
"kind": "task",
"repeat": {
"every": 183,
"unit": "day",
"mode": "calendar",
"weekdays": [
4
]
},
"visibility": "public",
"order": 123,
"notePath": "<string>",
"conversationPath": "<string>",
"assigneeId": "<string>",
"assignee": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"email": "<string>",
"image": "<string>"
},
"accessRole": "owner"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}Tasks
Create a task
Creates a task from structured fields. To create from a sentence, use POST /v2/tasks/quick instead.
A task belongs to a project or to an area, never both: if projectId is given, areaId is ignored.
POST
/
v2
/
tasks
Create a task
curl --request POST \
--url https://api.doers.sh/v2/tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"areaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversationPath": "<string>",
"deadline": "2023-12-25",
"durationMin": 727,
"headingId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notes": "<string>",
"order": 123,
"priority": 2,
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"repeat": {
"every": 183,
"weekdays": [
4
]
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tags": [
"<string>"
],
"time": "<string>"
}
'import requests
url = "https://api.doers.sh/v2/tasks"
payload = {
"title": "<string>",
"areaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversationPath": "<string>",
"deadline": "2023-12-25",
"durationMin": 727,
"headingId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"notes": "<string>",
"order": 123,
"priority": 2,
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"repeat": {
"every": 183,
"weekdays": [4]
},
"requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tags": ["<string>"],
"time": "<string>"
}
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: '<string>',
areaId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
conversationPath: '<string>',
deadline: '2023-12-25',
durationMin: 727,
headingId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
notes: '<string>',
order: 123,
priority: 2,
projectId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
repeat: {every: 183, weekdays: [4]},
requestId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
tags: ['<string>'],
time: '<string>'
})
};
fetch('https://api.doers.sh/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://api.doers.sh/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' => '<string>',
'areaId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'conversationPath' => '<string>',
'deadline' => '2023-12-25',
'durationMin' => 727,
'headingId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'notes' => '<string>',
'order' => 123,
'priority' => 2,
'projectId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'repeat' => [
'every' => 183,
'weekdays' => [
4
]
],
'requestId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'tags' => [
'<string>'
],
'time' => '<string>'
]),
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.doers.sh/v2/tasks"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"areaId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"conversationPath\": \"<string>\",\n \"deadline\": \"2023-12-25\",\n \"durationMin\": 727,\n \"headingId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"notes\": \"<string>\",\n \"order\": 123,\n \"priority\": 2,\n \"projectId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"repeat\": {\n \"every\": 183,\n \"weekdays\": [\n 4\n ]\n },\n \"requestId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tags\": [\n \"<string>\"\n ],\n \"time\": \"<string>\"\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.doers.sh/v2/tasks")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"areaId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"conversationPath\": \"<string>\",\n \"deadline\": \"2023-12-25\",\n \"durationMin\": 727,\n \"headingId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"notes\": \"<string>\",\n \"order\": 123,\n \"priority\": 2,\n \"projectId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"repeat\": {\n \"every\": 183,\n \"weekdays\": [\n 4\n ]\n },\n \"requestId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tags\": [\n \"<string>\"\n ],\n \"time\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.doers.sh/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\": \"<string>\",\n \"areaId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"conversationPath\": \"<string>\",\n \"deadline\": \"2023-12-25\",\n \"durationMin\": 727,\n \"headingId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"notes\": \"<string>\",\n \"order\": 123,\n \"priority\": 2,\n \"projectId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"repeat\": {\n \"every\": 183,\n \"weekdays\": [\n 4\n ]\n },\n \"requestId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tags\": [\n \"<string>\"\n ],\n \"time\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"task": {
"id": "<string>",
"title": "<string>",
"notes": "<string>",
"status": "open",
"priority": 0,
"when": {
"kind": "today"
},
"deadline": "<string>",
"projectId": "<string>",
"areaId": "<string>",
"headingId": "<string>",
"tags": [
"<string>"
],
"checklist": [
{
"id": "<string>",
"label": "<string>",
"done": true
}
],
"completedAt": 123,
"durationMin": 123,
"kind": "task",
"repeat": {
"every": 183,
"unit": "day",
"mode": "calendar",
"weekdays": [
4
]
},
"visibility": "public",
"order": 123,
"notePath": "<string>",
"conversationPath": "<string>",
"assigneeId": "<string>",
"assignee": {
"id": "<string>",
"username": "<string>",
"name": "<string>",
"email": "<string>",
"image": "<string>"
},
"accessRole": "owner"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}Authorizations
A pc_… token generated from Settings > API & MCP.
Body
application/json
Required string length:
1 - 500Identifier of a row.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Local Atelier conversation carrying this delegated task.
Maximum string length:
1024Due date, distinct from when.
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Required range:
15 <= x <= 1440Heading of the project or area that groups the task. null moves it back to the top. It must belong to the same parent as the task.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$event is a calendar block, excluded from task lists.
Available options:
task, event Markdown: bold, italic, headings, lists, quotes, rules, links, inline code, tables and checkboxes. Do not use code blocks (```) or images: the app's editor does not support them and truncates the display from that point on.
Maximum string length:
10000Manual position. Fractional values are valid; lower sorts first.
0 none · 1 low · 2 medium · 3 high · 4 “goal of the day”. Out of range is a 400.
Required range:
0 <= x <= 4Identifier of a row.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Repeat rule. null stops it repeating.
Show child attributes
Show child attributes
Stable creation request identifier. Reusing it returns the first task. If that task has been deleted, the request remains consumed and returns a conflict.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Maximum array length:
20Minimum string length:
1Time HH:MM — only meaningful alongside a date.
Pattern:
^([01]\d|2[0-3]):[0-5]\d$Who sees this task on shared and social surfaces. Defaults to private on create.
Available options:
public, anonymized, private Scheduling: today, anytime (Later), someday (Future), or a YYYY-MM-DD date. Not to be confused with deadline, which is the due date.
Available options:
today, anytime, someday Response
Created.
Show child attributes
Show child attributes