Mute Topline Alert

Reference for the POST /console/v1/alerts/{id}/mute endpoint of the Statsig API.

posthttps://statsigapi.net/console/v1/alerts/{id}/mute

Authorizations

STATSIG-API-KEYstringrequired

apiKey (header)

Path parameters

idstringrequired

id

Body

application/json
indefiniteboolean

Mute the alert indefinitely until manually unmuted

durationSecondsinteger

Mute duration in whole seconds

Constraints:format: int64min: 0
groupBysobject[]

Mute only alert evaluations matching these group-by values. Omit to mute the entire alert.

Show child attributes
keystringrequired

Group-by property key

valuestringrequired

Group-by value to mute

currentScheduleobject

Existing mute schedule to replace. Omit to update a mute that matches groupBys; use GET /alerts/:id activeMuteSchedules to discover values.

Constraints:nullable
Show child attributes
startnumberrequired

Start timestamp in seconds for the schedule being replaced (matches GraphQL mute schedule format)

Constraints:format: double
endnumberrequired

End timestamp in seconds for the schedule being replaced (0 means indefinite)

Constraints:format: double
groupBysobject[]required

Group-by values for the schedule being replaced (required to update a grouped mute)

keystringrequired

Group-by property key

valuestringrequired

Group-by value to mute

Response

application/json
200· Mute Alert success response
messagestringrequired

A simple string explaining the result of the operation.

dataobjectrequired
Show child attributes
idstringrequired

ID of the alert

namestringrequired

Name of the alert

alertTypestringrequired

Type of alert

Allowed values:thresholdchangepct_change
metricsobjectrequired

List of metrics associated with this alert

metricGroupBysobjectrequired

Metric groupbys

formulastring

Formula for the alert

messagestringrequired

Alert message

creatorIDstring
companyIDstringrequired
prioritystringrequired

Priority of this alert

Allowed values:P0P1P2P3P4P5
alertThresholdnumberrequired
Constraints:format: double
warningThresholdnumber
Constraints:format: double
windowMsnumberrequired

How far back and how frequently a metric should be checked, in milliseconds

Constraints:format: double
evaluationDelayMsnumber

Delay before evaluating metrics, in milliseconds. Use 0 or null to clear.

Constraints:format: doublenullable
conditionstringrequired

Condition under which a metric change triggers an alert in milliseconds

Allowed values:greatergreater_or_equallessless_or_equalequalnot_equal
renotificationConditionsstring[]

Condition under which a re-notification is sent

renotificationWindowMsnumber

How long to wait before re-notifying in milliseconds

Constraints:format: double
renotificationMessagestring

Re-notification message

teamstring

Team associated with this alert

Constraints:nullable
ownerobject

Schema for owner data including ID, type, name.

Example:{"ownerID":"user123","ownerType":"USER","ownerName":"John Doe","ownerEmail":"owner123@test.com"}
Constraints:nullable
ownerIDstring

ID of the owner

Example:abc123
ownerTypestring

Type of the owner (e.g., SDK_KEY or USER)

Example:USER
ownerNamestring

The name of the owner. This field is optional.

Example:John Doe
ownerEmailstring

The email of the owner. This field is optional.

tagsstring[]required

Tags associated with this alert

statusstringrequired

Current evaluation status of the alert

Allowed values:alertsetup_incompletestablewarn
Constraints:nullable
lastTriggeredTimenumberrequired

Timestamp in milliseconds of the last time this alert triggered

Constraints:format: doublenullable
activeMuteSchedulesobject[]required

Active v2 mute schedules for this alert, for use as currentSchedule when remuting

startnumberrequired

Mute schedule start timestamp in seconds

endnumberrequired

Mute schedule end timestamp in seconds (0 means indefinite)

groupBysobject[]required

Group-by values covered by this mute schedule (empty means whole alert)

keystringrequired

Group-by property key

valuestringrequired

Group-by value to mute

403· Forbidden resource
statusnumberrequired
Allowed values:403
messagestringrequired
Allowed values:Forbidden resource
404· Not Found. The requested resource could not be found.
statusintegerrequired
Allowed values:404
messagestringrequired

Was this helpful?