SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Tasks

Add a tag. 409 tag_exists returns the existing tag in error.details.tag. The connected member also needs to be allowed to change tasks

POSThttps://app.softsolz.uk/api/v1/services/tasks/tags

Recent Requests

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

Headers

Authorizationstringrequired

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

Body Params

namestringrequired

Tag name, up to 40 characters.

colourstring

One of the offered colours.

Response

Response Body

idintegerTag id.
namestringTag name.
colourstring | nullTag colour.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/tasks/tags \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"name": "Urgent",
"colour": "red"
}'

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 · 201

{
"data": {
"id": 7,
"name": "Urgent repair",
"colour": "red"
}
}