update_filter

mutationSeit v1.0

Ändert den Namen, die Beschreibung oder den Ausdruck eines gespeicherten Filters, der bestimmt, worauf er zutrifft. Der neue Ausdruck ersetzt den alten vollständig, statt ihn zu ergänzen. Wird sofort angewendet.

Parameter

Name	Typ	Pflichtfeld	Beschreibung
`filter`	`String`	✓	Der zu ändernde Filter, per ID oder Name.
`locale`	`String`	—	Schreibt den neuen Namen und die neue Beschreibung als Übersetzung für diese Sprache (zum Beispiel „de”) statt in den Basistext.
`set_expression`	`Object`	—	Neuer Ausdruck, der bestimmt, worauf der Filter zutrifft. Er ersetzt den bestehenden vollständig. Gleiche Form wie bei create_filter — zum Beispiel {"HasTag": {"tag": "critical"}} oder {"And": [...]}, um Bedingungen zu kombinieren. Den vollständigen Sprachumfang finden Sie im Hilfeartikel „Filterausdrücke schreiben”.
`set_description`	`String`	—	Neue Beschreibung für den Filter.
`set_name`	`String`	—	Neuer Name für den Filter.

Beispielanfrage

{"filter": "Open Risks", "set_name": "Critical Open Risks", "set_expression": {"And": [{"OfType": {"type_id": "Risk"}}, {"HasTag": {"tag": "critical"}}]}}

Beispielantwort

{"success": true, "operation_count": 1, "versions": [76]}