v1Ressources/Social Listening/patchUpdate a listening topic
Update a listening topic
Edits a topic, or turns it on or off with status. Turning a topic on schedules its first collection for the next monthly update; it does not start one now. A client needs a connected social account before a topic can be turned on.
patch
listening:write/api/v1/listening/topics/{id}Paramètres de requête
idstringobligatoire
The topic's id.
Corps de la requête
clientIdstringobligatoire
The client (business) this concerns.
namestringfacultatif
The topic's name, up to 80 characters.
descriptionstringfacultatif
An optional note, up to 255 characters. Send null to clear it.
queryobjectfacultatif
A replacement query, in the same shape as when creating a topic.
sourcesarray of stringfacultatif
The networks to follow.
languagesarray of stringfacultatif
Up to five two-letter language codes.
statusstring (active | paused | suggested)facultatif
active collects, paused stops, suggested keeps it as an idea.
Réponse
dataobjectfacultatif
topicobjectfacultatif
The topic after the change.
collectsNextstringfacultatif
When an active topic will next be collected, as a date-time. Present only when the change turned a topic on.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
patch/api/v1/listening/topics/{id}
Votre clé API
id *
Corps de la requête*
{}