CreateFilterAlert is an input datatype creating a filter alert. It's used by the createFilterAlert() mutation field.

Table: CreateFilterAlert

ParameterTypeRequiredDefaultStabilityAvailabilityDescription
Some input parameters may be required, as indicated in the Required column. For return values, this indicates that you are assured a value if the field is requested for the results. 
Table last updated: Oct 14, 2026 
actionIdsOrNamesStringyes Long-Term List of unique identifiers or names for actions to fire on query result. Actions in packages can be referred to as packagescope/packagename:actionname.
descriptionString  Long-Term Description of the filter alert.
enabledBoolean  Long-Term Flag indicating whether the filter alert is enabled.
labelsStringyes Long-Term Labels attached to the filter alert.
nameStringyes Long-Term Name of the filter alert.
queryOwnershipTypeQueryOwnershipTypeyes Long-Term Ownership of the query run by this filter alert. If value is User, ownership will be based on the runAsUserId field. See QueryOwnershipType.
queryStringStringyes Long-Term LogScale query to execute.
runAsUserIdString  Long-Term The filter alert will run with the permissions of the user corresponding to this id if the queryOwnershipType field is set to User. If the queryOwnershipType is set to Organization, whilst runAsUserId is set, this will result in an error. If not specified, the filter alert will run with the permissions of the calling user. It requires the ChangeTriggersToRunAsOtherUsers permission to set this field to a user id different from the calling user.
throttleFieldString  Deprecateddeprecated in 1.282The field on which to throttle. This can be set only if throttleTimeSeconds is set. Filter alerts now support multiple throttle fields. This field will be removed at the earliest in version 1.279. Use instead the throttleFields field.
throttleFieldsStringyes Long-Term The fields on which to throttle. This can be set only if throttleTimeSeconds is set. Ten throttle fields can be added at most.
throttleTimeSecondsLong  Long-Term Throttle time in seconds.
viewNameRepoOrViewNameyes Long-Term Name of the view of the filter alert. RepoOrViewName is a scalar.