curl --request POST \
--url 'https://api.flashcat.cloud/channel/silence/rule/update?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"channel_id": 1001,
"rule_id": "6621b23f4a2c5e0012ab34cd",
"rule_name": "Mute during maintenance",
"time_filter": {
"start_time": 1710000000,
"end_time": 1710086400
},
"filters": [
[
{
"key": "labels.service",
"oper": "IN",
"vals": [
"billing"
]
}
]
]
}
'import requests
url = "https://api.flashcat.cloud/channel/silence/rule/update?app_key="
payload = {
"channel_id": 1001,
"rule_id": "6621b23f4a2c5e0012ab34cd",
"rule_name": "Mute during maintenance",
"time_filter": {
"start_time": 1710000000,
"end_time": 1710086400
},
"filters": [[
{
"key": "labels.service",
"oper": "IN",
"vals": ["billing"]
}
]]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
channel_id: 1001,
rule_id: '6621b23f4a2c5e0012ab34cd',
rule_name: 'Mute during maintenance',
time_filter: {start_time: 1710000000, end_time: 1710086400},
filters: [[{key: 'labels.service', oper: 'IN', vals: ['billing']}]]
})
};
fetch('https://api.flashcat.cloud/channel/silence/rule/update?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/channel/silence/rule/update?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'channel_id' => 1001,
'rule_id' => '6621b23f4a2c5e0012ab34cd',
'rule_name' => 'Mute during maintenance',
'time_filter' => [
'start_time' => 1710000000,
'end_time' => 1710086400
],
'filters' => [
[
[
'key' => 'labels.service',
'oper' => 'IN',
'vals' => [
'billing'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/channel/silence/rule/update?app_key="
payload := strings.NewReader("{\n \"channel_id\": 1001,\n \"rule_id\": \"6621b23f4a2c5e0012ab34cd\",\n \"rule_name\": \"Mute during maintenance\",\n \"time_filter\": {\n \"start_time\": 1710000000,\n \"end_time\": 1710086400\n },\n \"filters\": [\n [\n {\n \"key\": \"labels.service\",\n \"oper\": \"IN\",\n \"vals\": [\n \"billing\"\n ]\n }\n ]\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/channel/silence/rule/update?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"channel_id\": 1001,\n \"rule_id\": \"6621b23f4a2c5e0012ab34cd\",\n \"rule_name\": \"Mute during maintenance\",\n \"time_filter\": {\n \"start_time\": 1710000000,\n \"end_time\": 1710086400\n },\n \"filters\": [\n [\n {\n \"key\": \"labels.service\",\n \"oper\": \"IN\",\n \"vals\": [\n \"billing\"\n ]\n }\n ]\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/channel/silence/rule/update?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"channel_id\": 1001,\n \"rule_id\": \"6621b23f4a2c5e0012ab34cd\",\n \"rule_name\": \"Mute during maintenance\",\n \"time_filter\": {\n \"start_time\": 1710000000,\n \"end_time\": 1710086400\n },\n \"filters\": [\n [\n {\n \"key\": \"labels.service\",\n \"oper\": \"IN\",\n \"vals\": [\n \"billing\"\n ]\n }\n ]\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Update silence rule
Update an existing silence rule configuration.
curl --request POST \
--url 'https://api.flashcat.cloud/channel/silence/rule/update?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"channel_id": 1001,
"rule_id": "6621b23f4a2c5e0012ab34cd",
"rule_name": "Mute during maintenance",
"time_filter": {
"start_time": 1710000000,
"end_time": 1710086400
},
"filters": [
[
{
"key": "labels.service",
"oper": "IN",
"vals": [
"billing"
]
}
]
]
}
'import requests
url = "https://api.flashcat.cloud/channel/silence/rule/update?app_key="
payload = {
"channel_id": 1001,
"rule_id": "6621b23f4a2c5e0012ab34cd",
"rule_name": "Mute during maintenance",
"time_filter": {
"start_time": 1710000000,
"end_time": 1710086400
},
"filters": [[
{
"key": "labels.service",
"oper": "IN",
"vals": ["billing"]
}
]]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
channel_id: 1001,
rule_id: '6621b23f4a2c5e0012ab34cd',
rule_name: 'Mute during maintenance',
time_filter: {start_time: 1710000000, end_time: 1710086400},
filters: [[{key: 'labels.service', oper: 'IN', vals: ['billing']}]]
})
};
fetch('https://api.flashcat.cloud/channel/silence/rule/update?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/channel/silence/rule/update?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'channel_id' => 1001,
'rule_id' => '6621b23f4a2c5e0012ab34cd',
'rule_name' => 'Mute during maintenance',
'time_filter' => [
'start_time' => 1710000000,
'end_time' => 1710086400
],
'filters' => [
[
[
'key' => 'labels.service',
'oper' => 'IN',
'vals' => [
'billing'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/channel/silence/rule/update?app_key="
payload := strings.NewReader("{\n \"channel_id\": 1001,\n \"rule_id\": \"6621b23f4a2c5e0012ab34cd\",\n \"rule_name\": \"Mute during maintenance\",\n \"time_filter\": {\n \"start_time\": 1710000000,\n \"end_time\": 1710086400\n },\n \"filters\": [\n [\n {\n \"key\": \"labels.service\",\n \"oper\": \"IN\",\n \"vals\": [\n \"billing\"\n ]\n }\n ]\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/channel/silence/rule/update?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"channel_id\": 1001,\n \"rule_id\": \"6621b23f4a2c5e0012ab34cd\",\n \"rule_name\": \"Mute during maintenance\",\n \"time_filter\": {\n \"start_time\": 1710000000,\n \"end_time\": 1710086400\n },\n \"filters\": [\n [\n {\n \"key\": \"labels.service\",\n \"oper\": \"IN\",\n \"vals\": [\n \"billing\"\n ]\n }\n ]\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/channel/silence/rule/update?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"channel_id\": 1001,\n \"rule_id\": \"6621b23f4a2c5e0012ab34cd\",\n \"rule_name\": \"Mute during maintenance\",\n \"time_filter\": {\n \"start_time\": 1710000000,\n \"end_time\": 1710086400\n },\n \"filters\": [\n [\n {\n \"key\": \"labels.service\",\n \"oper\": \"IN\",\n \"vals\": [\n \"billing\"\n ]\n }\n ]\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Restrictions
| Aspect | Value |
|---|---|
| Rate limits | 1,000 requests/minute; 50 requests/second per account |
| Permissions | Channels Manage (on-call) |
Authorizations
App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Parameters for updating a silence rule. Exactly one of time_filter or time_filters must be provided, and filters must be non-empty.
Owning channel ID; obtain it from POST /channel/list.
Silence rule ID (MongoDB ObjectID).
^[0-9a-fA-F]{24}$Rule name, 1 to 39 characters.
1 - 39Rule description, up to 500 characters.
500Recurring time windows. Mutually exclusive with time_filter.
Show child attributes
Show child attributes
One-off silence window. Mutually exclusive with time_filters; exactly one of the two must be set.
Show child attributes
Show child attributes
Match conditions for the alerts to silence; required and must not be empty.
AND group — all conditions in this array must match.
Show child attributes
Show child attributes
When true, matching alert events are discarded entirely; when false, alerts are still recorded but marked as muted by this rule.
When true, the silence rule is automatically deleted after its time window expires. Defaults to false.
Response
Success
Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.
Was this page helpful?