curl --request POST \
--url 'https://api.flashcat.cloud/channel/silence/rule/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"channel_id": 3521074710131,
"rule_name": "Maintenance window silence",
"description": "Silence all Info alerts during planned maintenance",
"time_filter": {
"start_time": 1773388800,
"end_time": 1773414000
},
"filters": [
[
{
"key": "severity",
"oper": "IN",
"vals": [
"Info"
]
}
]
],
"is_directly_discard": false
}
'import requests
url = "https://api.flashcat.cloud/channel/silence/rule/create?app_key="
payload = {
"channel_id": 3521074710131,
"rule_name": "Maintenance window silence",
"description": "Silence all Info alerts during planned maintenance",
"time_filter": {
"start_time": 1773388800,
"end_time": 1773414000
},
"filters": [[
{
"key": "severity",
"oper": "IN",
"vals": ["Info"]
}
]],
"is_directly_discard": False
}
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: 3521074710131,
rule_name: 'Maintenance window silence',
description: 'Silence all Info alerts during planned maintenance',
time_filter: {start_time: 1773388800, end_time: 1773414000},
filters: [[{key: 'severity', oper: 'IN', vals: ['Info']}]],
is_directly_discard: false
})
};
fetch('https://api.flashcat.cloud/channel/silence/rule/create?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/create?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' => 3521074710131,
'rule_name' => 'Maintenance window silence',
'description' => 'Silence all Info alerts during planned maintenance',
'time_filter' => [
'start_time' => 1773388800,
'end_time' => 1773414000
],
'filters' => [
[
[
'key' => 'severity',
'oper' => 'IN',
'vals' => [
'Info'
]
]
]
],
'is_directly_discard' => false
]),
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/create?app_key="
payload := strings.NewReader("{\n \"channel_id\": 3521074710131,\n \"rule_name\": \"Maintenance window silence\",\n \"description\": \"Silence all Info alerts during planned maintenance\",\n \"time_filter\": {\n \"start_time\": 1773388800,\n \"end_time\": 1773414000\n },\n \"filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Info\"\n ]\n }\n ]\n ],\n \"is_directly_discard\": false\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/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"channel_id\": 3521074710131,\n \"rule_name\": \"Maintenance window silence\",\n \"description\": \"Silence all Info alerts during planned maintenance\",\n \"time_filter\": {\n \"start_time\": 1773388800,\n \"end_time\": 1773414000\n },\n \"filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Info\"\n ]\n }\n ]\n ],\n \"is_directly_discard\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/channel/silence/rule/create?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\": 3521074710131,\n \"rule_name\": \"Maintenance window silence\",\n \"description\": \"Silence all Info alerts during planned maintenance\",\n \"time_filter\": {\n \"start_time\": 1773388800,\n \"end_time\": 1773414000\n },\n \"filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Info\"\n ]\n }\n ]\n ],\n \"is_directly_discard\": false\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"rule_id": "69db2f66a0fe7db6448b1503",
"rule_name": "Test silence rule"
}
}{
"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."
}
}Create silence rule
Create a silence rule to suppress notifications matching specified conditions.
curl --request POST \
--url 'https://api.flashcat.cloud/channel/silence/rule/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"channel_id": 3521074710131,
"rule_name": "Maintenance window silence",
"description": "Silence all Info alerts during planned maintenance",
"time_filter": {
"start_time": 1773388800,
"end_time": 1773414000
},
"filters": [
[
{
"key": "severity",
"oper": "IN",
"vals": [
"Info"
]
}
]
],
"is_directly_discard": false
}
'import requests
url = "https://api.flashcat.cloud/channel/silence/rule/create?app_key="
payload = {
"channel_id": 3521074710131,
"rule_name": "Maintenance window silence",
"description": "Silence all Info alerts during planned maintenance",
"time_filter": {
"start_time": 1773388800,
"end_time": 1773414000
},
"filters": [[
{
"key": "severity",
"oper": "IN",
"vals": ["Info"]
}
]],
"is_directly_discard": False
}
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: 3521074710131,
rule_name: 'Maintenance window silence',
description: 'Silence all Info alerts during planned maintenance',
time_filter: {start_time: 1773388800, end_time: 1773414000},
filters: [[{key: 'severity', oper: 'IN', vals: ['Info']}]],
is_directly_discard: false
})
};
fetch('https://api.flashcat.cloud/channel/silence/rule/create?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/create?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' => 3521074710131,
'rule_name' => 'Maintenance window silence',
'description' => 'Silence all Info alerts during planned maintenance',
'time_filter' => [
'start_time' => 1773388800,
'end_time' => 1773414000
],
'filters' => [
[
[
'key' => 'severity',
'oper' => 'IN',
'vals' => [
'Info'
]
]
]
],
'is_directly_discard' => false
]),
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/create?app_key="
payload := strings.NewReader("{\n \"channel_id\": 3521074710131,\n \"rule_name\": \"Maintenance window silence\",\n \"description\": \"Silence all Info alerts during planned maintenance\",\n \"time_filter\": {\n \"start_time\": 1773388800,\n \"end_time\": 1773414000\n },\n \"filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Info\"\n ]\n }\n ]\n ],\n \"is_directly_discard\": false\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/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"channel_id\": 3521074710131,\n \"rule_name\": \"Maintenance window silence\",\n \"description\": \"Silence all Info alerts during planned maintenance\",\n \"time_filter\": {\n \"start_time\": 1773388800,\n \"end_time\": 1773414000\n },\n \"filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Info\"\n ]\n }\n ]\n ],\n \"is_directly_discard\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/channel/silence/rule/create?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\": 3521074710131,\n \"rule_name\": \"Maintenance window silence\",\n \"description\": \"Silence all Info alerts during planned maintenance\",\n \"time_filter\": {\n \"start_time\": 1773388800,\n \"end_time\": 1773414000\n },\n \"filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Info\"\n ]\n }\n ]\n ],\n \"is_directly_discard\": false\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"rule_id": "69db2f66a0fe7db6448b1503",
"rule_name": "Test silence rule"
}
}{
"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 creating a silence rule. Exactly one of time_filter or time_filters must be provided, and filters must be non-empty.
Channel the rule belongs to.
Rule name, 1 to 39 characters.
1 - 39Evaluation priority. Lower runs first.
Rule description, up to 500 characters.
500Source incident ID when the silence was created from an incident.
Recurring time windows during which silencing applies. Mutually exclusive with time_filter.
Show child attributes
Show child attributes
One-off time window defined by unix seconds.
Show child attributes
Show child attributes
Or-of-and filter tree. Each outer element is an AND group; within each group, all conditions must match.
Show child attributes
Show child attributes
When true, silenced alerts are dropped instead of suppressed into incidents.
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?