Tasks

To-dos with a status, priority, due date and assignees.

GET/tasksList tasks
POST/tasksCreate a task
GET/tasks/{id}Get a task by id
PATCH/tasks/{id}Update a task
DELETE/tasks/{id}Delete a task

List tasks

GET/tasks

Scope tasks:viewRead-only

Query parameters

Name	Type
`limit`	number
`cursor`	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/tasks?limit=25" \  -H "Authorization: Bearer $KLERC_TOKEN"

Create a task

POST/tasks

Scope tasks:useWrites data

Request body

Field	Type
`title`	string
`text`	string
`status`	string
`priority`	string
`dueDate`	string
`assignees`	array of string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/tasks" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"title":"Call back about the renewal quote","text":"Asked for a call after 6pm."}'

Get a task by id

GET/tasks/{id}

Scope tasks:viewRead-only

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/tasks/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN"

Update a task

PATCH/tasks/{id}

Scope tasks:useWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`title`	string
`text`	string
`status`	string
`priority`	string
`dueDate`	string
`assignees`	array of string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PATCH "https://api.klerc.co/api/v1/tasks/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"title":"…","text":"…","status":"…","priority":"…","dueDate":"…","assignees":["…"]}'

Delete a task

DELETE/tasks/{id}

Scope tasks:useWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X DELETE "https://api.klerc.co/api/v1/tasks/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN"