Skip to content

/api/v1/lists/{listId}/tasks (POST)

POST
/api/v1/lists/{listId}/tasks
curl --request POST \
--url https://example.com/api/v1/lists/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/tasks \
--header 'Content-Type: application/json' \
--data '{ "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "title": "example" }'
listId
required
string format: uuid
Media type application/json
object
id
required
string format: uuid
title
required
string
>= 1 characters <= 500 characters
Example generated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"title": "example"
}

Created

Media type application/json
object
id
required
string format: uuid
listId
required
string format: uuid
title
required
string
>= 1 characters <= 500 characters
done
required
boolean
starred
required
boolean
dueDate
required
string | null
/^\d{4}-\d{2}-\d{2}$/
notes
required
string | null
<= 10000 characters
notesUpdatedAt
required
string | null
rank
required
string
>= 1 characters
assigneeId
required
string | null
assignedToMe
boolean
createdAt
required
string
updatedAt
required
string
deletedAt
string
Example generated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"listId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"title": "example",
"done": true,
"starred": true,
"dueDate": "example",
"notes": "example",
"notesUpdatedAt": "example",
"rank": "example",
"assigneeId": "example",
"assignedToMe": true,
"createdAt": "example",
"updatedAt": "example",
"deletedAt": "example"
}

No valid session

Media type application/problem+json
object
type
required
string
title
required
string
status
required
number
code
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example"
}

Parent List not found

Media type application/problem+json
object
type
required
string
title
required
string
status
required
number
code
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example"
}

Idempotency-Key reused with a different request

Media type application/problem+json
object
type
required
string
title
required
string
status
required
number
code
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example"
}