v1Ressourcen/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}Query-Parameter
idstringerforderlich
The topic's id.
Anfragetext
clientIdstringerforderlich
The client (business) this concerns.
namestringoptional
The topic's name, up to 80 characters.
descriptionstringoptional
An optional note, up to 255 characters. Send null to clear it.
queryobjectoptional
A replacement query, in the same shape as when creating a topic.
sourcesarray of stringoptional
The networks to follow.
languagesarray of stringoptional
Up to five two-letter language codes.
statusstring (active | paused | suggested)optional
active collects, paused stops, suggested keeps it as an idea.
Antwort
dataobjectoptional
topicobjectoptional
The topic after the change.
collectsNextstringoptional
When an active topic will next be collected, as a date-time. Present only when the change turned a topic on.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
patch/api/v1/listening/topics/{id}
Ihr API-Schlüssel
id *
Anfragetext*
{}