curl --request POST \
--url 'https://api.flashcat.cloud/channel/inhibit/rule/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"channel_id": 3521074710131,
"rule_name": "Suppress Info when Critical fires",
"description": "When a Critical alert fires, suppress matching Info alerts",
"equals": [
"labels.cluster",
"labels.service"
],
"source_filters": [
[
{
"key": "severity",
"oper": "IN",
"vals": [
"Critical"
]
}
]
],
"target_filters": [
[
{
"key": "severity",
"oper": "IN",
"vals": [
"Info"
]
}
]
],
"is_directly_discard": false
}
'import requests
url = "https://api.flashcat.cloud/channel/inhibit/rule/create?app_key="
payload = {
"channel_id": 3521074710131,
"rule_name": "Suppress Info when Critical fires",
"description": "When a Critical alert fires, suppress matching Info alerts",
"equals": ["labels.cluster", "labels.service"],
"source_filters": [[
{
"key": "severity",
"oper": "IN",
"vals": ["Critical"]
}
]],
"target_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: 'Suppress Info when Critical fires',
description: 'When a Critical alert fires, suppress matching Info alerts',
equals: ['labels.cluster', 'labels.service'],
source_filters: [[{key: 'severity', oper: 'IN', vals: ['Critical']}]],
target_filters: [[{key: 'severity', oper: 'IN', vals: ['Info']}]],
is_directly_discard: false
})
};
fetch('https://api.flashcat.cloud/channel/inhibit/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/inhibit/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' => 'Suppress Info when Critical fires',
'description' => 'When a Critical alert fires, suppress matching Info alerts',
'equals' => [
'labels.cluster',
'labels.service'
],
'source_filters' => [
[
[
'key' => 'severity',
'oper' => 'IN',
'vals' => [
'Critical'
]
]
]
],
'target_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/inhibit/rule/create?app_key="
payload := strings.NewReader("{\n \"channel_id\": 3521074710131,\n \"rule_name\": \"Suppress Info when Critical fires\",\n \"description\": \"When a Critical alert fires, suppress matching Info alerts\",\n \"equals\": [\n \"labels.cluster\",\n \"labels.service\"\n ],\n \"source_filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ]\n ],\n \"target_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/inhibit/rule/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"channel_id\": 3521074710131,\n \"rule_name\": \"Suppress Info when Critical fires\",\n \"description\": \"When a Critical alert fires, suppress matching Info alerts\",\n \"equals\": [\n \"labels.cluster\",\n \"labels.service\"\n ],\n \"source_filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ]\n ],\n \"target_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/inhibit/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\": \"Suppress Info when Critical fires\",\n \"description\": \"When a Critical alert fires, suppress matching Info alerts\",\n \"equals\": [\n \"labels.cluster\",\n \"labels.service\"\n ],\n \"source_filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ]\n ],\n \"target_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": "69db2f69a0fe7db6448b1504",
"rule_name": "Test inhibit 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 inhibit rule
Create an inhibit rule to suppress lower-priority alerts when higher-priority ones are firing.
curl --request POST \
--url 'https://api.flashcat.cloud/channel/inhibit/rule/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"channel_id": 3521074710131,
"rule_name": "Suppress Info when Critical fires",
"description": "When a Critical alert fires, suppress matching Info alerts",
"equals": [
"labels.cluster",
"labels.service"
],
"source_filters": [
[
{
"key": "severity",
"oper": "IN",
"vals": [
"Critical"
]
}
]
],
"target_filters": [
[
{
"key": "severity",
"oper": "IN",
"vals": [
"Info"
]
}
]
],
"is_directly_discard": false
}
'import requests
url = "https://api.flashcat.cloud/channel/inhibit/rule/create?app_key="
payload = {
"channel_id": 3521074710131,
"rule_name": "Suppress Info when Critical fires",
"description": "When a Critical alert fires, suppress matching Info alerts",
"equals": ["labels.cluster", "labels.service"],
"source_filters": [[
{
"key": "severity",
"oper": "IN",
"vals": ["Critical"]
}
]],
"target_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: 'Suppress Info when Critical fires',
description: 'When a Critical alert fires, suppress matching Info alerts',
equals: ['labels.cluster', 'labels.service'],
source_filters: [[{key: 'severity', oper: 'IN', vals: ['Critical']}]],
target_filters: [[{key: 'severity', oper: 'IN', vals: ['Info']}]],
is_directly_discard: false
})
};
fetch('https://api.flashcat.cloud/channel/inhibit/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/inhibit/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' => 'Suppress Info when Critical fires',
'description' => 'When a Critical alert fires, suppress matching Info alerts',
'equals' => [
'labels.cluster',
'labels.service'
],
'source_filters' => [
[
[
'key' => 'severity',
'oper' => 'IN',
'vals' => [
'Critical'
]
]
]
],
'target_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/inhibit/rule/create?app_key="
payload := strings.NewReader("{\n \"channel_id\": 3521074710131,\n \"rule_name\": \"Suppress Info when Critical fires\",\n \"description\": \"When a Critical alert fires, suppress matching Info alerts\",\n \"equals\": [\n \"labels.cluster\",\n \"labels.service\"\n ],\n \"source_filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ]\n ],\n \"target_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/inhibit/rule/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"channel_id\": 3521074710131,\n \"rule_name\": \"Suppress Info when Critical fires\",\n \"description\": \"When a Critical alert fires, suppress matching Info alerts\",\n \"equals\": [\n \"labels.cluster\",\n \"labels.service\"\n ],\n \"source_filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ]\n ],\n \"target_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/inhibit/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\": \"Suppress Info when Critical fires\",\n \"description\": \"When a Critical alert fires, suppress matching Info alerts\",\n \"equals\": [\n \"labels.cluster\",\n \"labels.service\"\n ],\n \"source_filters\": [\n [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ]\n ],\n \"target_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": "69db2f69a0fe7db6448b1504",
"rule_name": "Test inhibit 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 an inhibit rule.
Channel the rule belongs to.
Rule name, 1 to 39 characters.
1 - 39Label keys used to pair source and target alerts.
Evaluation priority. Lower runs first.
Rule description, up to 500 characters.
500Or-of-and filter tree. Each outer element is an AND group; within each group, all conditions must match.
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, suppressed target alerts are dropped instead of merged.
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?