Passer au contenu principal
PATCH
Mettre à jour le suivi
Met à jour les réglages de suivi fournis. Lisez d’abord Obtenir le suivi et copiez son ETag. Lorsque le GET renvoie des valeurs par défaut calculées, l’ETag initial est "0" ; ce PATCH enregistre les premiers réglages. Les champs omis gardent les valeurs par défaut : aucun modèle et pas de réponses automatiques. Nécessite une offre Business, Agency Business ou Enterprise active. Utilisez un jeton d’API dont l’accès en écriture est activé. Consultez Écrire des données pour l’idempotence, les requêtes conditionnelles et la gestion des erreurs.
string
requis
Jeton bearer de votre équipe.
string
requis
Copiez l’ETag complet du dernier GET, guillemets compris.
string
requis
Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.
string
NONE, DAILY, WEEKLY ou MONTHLY. NONE arrête le calendrier du workspace : les prompts qui en héritent s’arrêtent, ceux qui ont leur propre fréquence continuent, comme dans le dashboard.
integer | null
Jour de 1 à 7 pour le suivi hebdomadaire. Pour les premiers réglages enregistrés, une valeur omise ou null utilise le jour de la semaine en cours ; les mises à jour suivantes peuvent enregistrer null.
integer | null
Jour de 1 à 28 pour le suivi mensuel. Pour les premiers réglages enregistrés, une valeur omise ou null utilise le jour 1 ; les mises à jour suivantes peuvent enregistrer null.
boolean
Indique si l’analyse planifiée génère automatiquement des réponses.
string[]
Liste de remplacement de 1 à 20 codes de modèles Qwairy activés. Lisez les codes actuellement sélectionnés avec GET. Les codes inconnus ou désactivés sont rejetés.
boolean
défaut:"false"
Valide le changement et renvoie le résultat sans rien modifier.
Fournissez au moins un champ modifiable. Passer à NONE conserve les réglages de suivi de chaque prompt. Le travail accepté avant le changement peut encore se terminer.

Réponse

Renvoie 200, un nouvel ETag et un objet monitoring avec les mêmes champs que Obtenir le suivi. paused indique si frequency vaut NONE ; isDefault est faux une fois les réglages enregistrés.

Requête et réponse synthétiques

Cet exemple suppose que l’ETag actuel du suivi est "3".

Erreurs

Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur 429, respectez Retry-After ; les écritures peuvent renvoyer 503 SERVICE_UNAVAILABLE si le limiteur d’écriture est indisponible.