SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Tasks

Choose when a task with subtasks counts as done. The connected member also needs to be allowed to change tasks

PUThttps://app.softsolz.uk/api/v1/services/tasks/tasks/{id}/completion-rule

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Body Params

modestringrequired

manual: never by itself. all: when every subtask is done. selected: when the listed subtasks are done. percent: when that share is done.

task_idsarray of integers

For mode selected.

percentinteger

For mode percent, 1 to 100.

Response

Response Body

ruleobjectThe saved rule.
progressobjectHow many subtasks are done.

Request

curl --request PUT \
--url https://app.softsolz.uk/api/v1/services/tasks/tasks/{id}/completion-rule \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"mode": "percent",
"percent": 80
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"rule": {
"mode": "manual",
"task_ids": [
1
],
"percent": 80
},
"progress": {
"done": 2,
"total": 5,
"percent": 40
}
}
}