Endpoints / setWatchState

setWatchState

Watch-Status (join/leave/markRead) idempotent setzen

Idempotent: watching=true fügt User als Watcher hinzu, false entfernt. read=true setzt LastReadActivity auf jetzt.

HTTP Request

POST https://dev.vitabyte.ch/v1/sales/setWatchState
Auth basicAuth apiKey

Request Parameters

Parameter Pflicht Typ Beispiel / Default
leadId required integer
userId required integer
watching

true=join, false=leave

 optional boolean
read

true=als gelesen markieren

 optional boolean

Response Parameters

Field Typ Beschreibung
status boolean true bei Erfolg, false bei Fehler
msg string Kurzbeschreibung des Resultats / der Fehlerursache
result Endpoint-spezifisches Resultat. Typ je nach Endpoint (Object, Array, Skalar oder null).
pagination Nur bei Listen-Endpoints gesetzt

Demo

POST https://dev.vitabyte.ch/v1/sales/setWatchState
Payload
{
    "leadId": 12345,
    "userId": 42,
    "watching": true,
    "read": true
}
Response