SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Tasks

Replace the tags on a task, up to 20. Names that do not exist yet are created. The connected member also needs to be allowed to change tasks

PUThttps://app.softsolz.uk/api/v1/services/tasks/tasks/{id}/tags

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

tag_idsarray of integers

Existing tags to keep or add.

namesarray of strings

Tag names, created when missing.

Response

Response Body · array of objects

idintegerTag id.
namestringTag name.
colourstring | nullTag colour.

Request

curl --request PUT \
--url https://app.softsolz.uk/api/v1/services/tasks/tasks/{id}/tags \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"tag_ids": [
7
],
"names": [
"Follow up"
]
}'

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": [
{
"id": 7,
"name": "Urgent repair",
"colour": "red"
}
]
}