Replace the watcher list. Watchers follow a task without being an assignee or reviewer and receive only task-level notices
PUT
https://app.softsolz.uk/api/v1/services/tasks/tasks/{id}/watchersRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Idempotency-KeystringOptional idempotency key for safe retries.
Body Params
user_idsarray of integersrequiredThe complete watcher list.
rolesobjectOptional role per member, keyed by user id. Leave it out to keep the roles people already have. 400 invalid_watcher_role for any other value.
Response
Response Body
user_idsarray of integersThe stored watcher list.watchersarray of objectsThe stored watchers with their roles.Request
curl --request PUT \ --url https://app.softsolz.uk/api/v1/services/tasks/tasks/{id}/watchers \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "user_ids": [ 12 ], "roles": { "12": "consulted" }}'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": { "user_ids": [ 12 ], "watchers": [ { "user_id": 1, "role": "watcher" } ] }}