Search Tasks

GET {{url}}/{{tenantName}}/{{instanceName}}/tasks

Example overview

Search tasks by many parameters

Default behaviour for requests by user: return list of tasks, where current user is assignee or watcher.

Default behaviour for requests by API-Client: return list of all tasks

HTTP Request

Method: GET

Endpoint: {url}/{tenantName}/{instanceName}/tasks

in our example it would be: https://api.live.welkincloud.io/gh/sb-demo/tasks

Deprecated parameters

NameLocated inDescriptionRequiredType
assigneeIdpathreplased to assigneeIdsNoUUID (or comma separated list of UUID)
patientIdpathreplased to patientIdsNoUUID
statuspathreplased to statusesNo[TODO, IN_PROGRESS, COMPLETED, CANCELED] - one or more comma separated
prioritypathreplased to prioritiesNo[LOW, MEDIUM, HIGH, URGENT] - one or more comma separated

Responses

CodeDescription
200OK
401Unauthorized
403Forbidden
404Not Found

Request Params

KeyDatatypeRequiredDescription
templatesstringLooks for tasks with template. String (or comma separated list of string)
withoutTemplatebooleanLooks for tasks without template
assigneeIdsstringassigneeIds
patientIdsstringLooks for tasks related to patient. UUID (or comma separated list of UUID)
statusesstringLooks for tasks with status [TODO, IN_PROGRESS, COMPLETED, CANCELED] - one or more comma separated
prioritiesstringLooks for tasks with priority [LOW, MEDIUM, HIGH, URGENT] - one or more comma separated
dueBeforestringLooks for tasks whose deadline is up to the specified day. Datetime in ISO-8601 format
dueAfterstringLooks for tasks whose deadline is after the specified day. Datetime in ISO-8601 format
authorIdstringLooks for tasks created by user ( UUID)
dueDatestringLooks for tasks whose deadline is on the specified day. Datetime in ISO-8601 format
searchstringSearch by name or description
descriptionstringLooks for tasks whose descriptions partially matches the specified one
watcherIdstringLooks for tasks monitored by the specified user (UUID)
sizenumber
pagenumber
sortnull