update_filter

mutationSince v1.0

Change a stored filter's name, description, or the expression that decides what it matches. The new expression replaces the old one outright rather than being added to it. Applied immediately.

Parameters

Name	Type	Required	Description
`filter`	`String`	✓	The filter to change, by ID or name.
`locale`	`String`	—	Write the new name and description as this language's translation (for example 'de') rather than to the base text.
`set_expression`	`Object`	—	New expression deciding what the filter matches. It replaces the existing one completely. Same shape as create_filter — for example {"HasTag": {"tag": "critical"}}, or {"And": [...]} to combine conditions. See the help article "Writing Filter Expressions" for the full vocabulary.
`set_description`	`String`	—	New description for the filter.
`set_name`	`String`	—	New name for the filter.

Example Request

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

Example Response

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