Skip to content

/api/v1/lists/{listId}/tasks/{taskId}/rank

PATCH
/api/v1/lists/{listId}/tasks/{taskId}/rank
curl --request PATCH \
--url https://example.com/api/v1/lists/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/tasks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/rank \
--header 'Content-Type: application/json' \
--data '{ "beforeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "afterId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'
listId
required
string format: uuid
taskId
required
string format: uuid
Media type application/json
object
beforeId
string | null format: uuid
afterId
string | null format: uuid
Example generated
{
"beforeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"afterId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Reordered

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"
}

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"
}

Invalid neighbor envelope

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"
}