Upsert routing rule
curl --request POST \
--url 'https://api.flashcat.cloud/route/upsert?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"integration_id": 6113996590131,
"cases": [
{
"if": [
{
"key": "severity",
"oper": "IN",
"vals": [
"Critical"
]
}
],
"channel_ids": [
3521074710131
],
"fallthrough": false,
"routing_mode": "standard"
}
],
"default": {
"channel_ids": [
3521074710131
]
}
}
'import requests
url = "https://api.flashcat.cloud/route/upsert?app_key="
payload = {
"integration_id": 6113996590131,
"cases": [
{
"if": [
{
"key": "severity",
"oper": "IN",
"vals": ["Critical"]
}
],
"channel_ids": [3521074710131],
"fallthrough": False,
"routing_mode": "standard"
}
],
"default": { "channel_ids": [3521074710131] }
}
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({
integration_id: 6113996590131,
cases: [
{
if: [{key: 'severity', oper: 'IN', vals: ['Critical']}],
channel_ids: [3521074710131],
fallthrough: false,
routing_mode: 'standard'
}
],
default: {channel_ids: [3521074710131]}
})
};
fetch('https://api.flashcat.cloud/route/upsert?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/route/upsert?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([
'integration_id' => 6113996590131,
'cases' => [
[
'if' => [
[
'key' => 'severity',
'oper' => 'IN',
'vals' => [
'Critical'
]
]
],
'channel_ids' => [
3521074710131
],
'fallthrough' => false,
'routing_mode' => 'standard'
]
],
'default' => [
'channel_ids' => [
3521074710131
]
]
]),
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/route/upsert?app_key="
payload := strings.NewReader("{\n \"integration_id\": 6113996590131,\n \"cases\": [\n {\n \"if\": [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ],\n \"channel_ids\": [\n 3521074710131\n ],\n \"fallthrough\": false,\n \"routing_mode\": \"standard\"\n }\n ],\n \"default\": {\n \"channel_ids\": [\n 3521074710131\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/route/upsert?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"integration_id\": 6113996590131,\n \"cases\": [\n {\n \"if\": [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ],\n \"channel_ids\": [\n 3521074710131\n ],\n \"fallthrough\": false,\n \"routing_mode\": \"standard\"\n }\n ],\n \"default\": {\n \"channel_ids\": [\n 3521074710131\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/route/upsert?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 \"integration_id\": 6113996590131,\n \"cases\": [\n {\n \"if\": [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ],\n \"channel_ids\": [\n 3521074710131\n ],\n \"fallthrough\": false,\n \"routing_mode\": \"standard\"\n }\n ],\n \"default\": {\n \"channel_ids\": [\n 3521074710131\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"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": "AccessDenied",
"message": "Access Denied."
}
}{
"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."
}
}Routing rules
Upsert routing rule
Create or replace the routing rule that sends a shared integration’s alerts to channels.
POST
/
route
/
upsert
Upsert routing rule
curl --request POST \
--url 'https://api.flashcat.cloud/route/upsert?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"integration_id": 6113996590131,
"cases": [
{
"if": [
{
"key": "severity",
"oper": "IN",
"vals": [
"Critical"
]
}
],
"channel_ids": [
3521074710131
],
"fallthrough": false,
"routing_mode": "standard"
}
],
"default": {
"channel_ids": [
3521074710131
]
}
}
'import requests
url = "https://api.flashcat.cloud/route/upsert?app_key="
payload = {
"integration_id": 6113996590131,
"cases": [
{
"if": [
{
"key": "severity",
"oper": "IN",
"vals": ["Critical"]
}
],
"channel_ids": [3521074710131],
"fallthrough": False,
"routing_mode": "standard"
}
],
"default": { "channel_ids": [3521074710131] }
}
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({
integration_id: 6113996590131,
cases: [
{
if: [{key: 'severity', oper: 'IN', vals: ['Critical']}],
channel_ids: [3521074710131],
fallthrough: false,
routing_mode: 'standard'
}
],
default: {channel_ids: [3521074710131]}
})
};
fetch('https://api.flashcat.cloud/route/upsert?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/route/upsert?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([
'integration_id' => 6113996590131,
'cases' => [
[
'if' => [
[
'key' => 'severity',
'oper' => 'IN',
'vals' => [
'Critical'
]
]
],
'channel_ids' => [
3521074710131
],
'fallthrough' => false,
'routing_mode' => 'standard'
]
],
'default' => [
'channel_ids' => [
3521074710131
]
]
]),
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/route/upsert?app_key="
payload := strings.NewReader("{\n \"integration_id\": 6113996590131,\n \"cases\": [\n {\n \"if\": [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ],\n \"channel_ids\": [\n 3521074710131\n ],\n \"fallthrough\": false,\n \"routing_mode\": \"standard\"\n }\n ],\n \"default\": {\n \"channel_ids\": [\n 3521074710131\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/route/upsert?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"integration_id\": 6113996590131,\n \"cases\": [\n {\n \"if\": [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ],\n \"channel_ids\": [\n 3521074710131\n ],\n \"fallthrough\": false,\n \"routing_mode\": \"standard\"\n }\n ],\n \"default\": {\n \"channel_ids\": [\n 3521074710131\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/route/upsert?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 \"integration_id\": 6113996590131,\n \"cases\": [\n {\n \"if\": [\n {\n \"key\": \"severity\",\n \"oper\": \"IN\",\n \"vals\": [\n \"Critical\"\n ]\n }\n ],\n \"channel_ids\": [\n 3521074710131\n ],\n \"fallthrough\": false,\n \"routing_mode\": \"standard\"\n }\n ],\n \"default\": {\n \"channel_ids\": [\n 3521074710131\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
}{
"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": "AccessDenied",
"message": "Access Denied."
}
}{
"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 | 300 requests/minute; 20 requests/second per account |
| Permissions | Integrations Manage (on-call) |
Usage
- The whole rule is replaced:
cases,sectionsordefaultmissing from the request are removed.versionincreases on every call and the previous version is kept in the route history. - At least one of
casesordefaultis required; adefaultwith emptychannel_idscounts as absent. - Only shared integrations have routing rules: a channel-exclusive or unknown
integration_id, or a channel ID that does not exist, returnsInvalidParameter. - When the integration belongs to a team, the caller must be the account owner or an admin, the integration’s creator, or a member of that team; otherwise
AccessDenied. - A successful response carries only
request_id, with nodatafield. - Every call is recorded in the account audit log.
Authorizations
Body
application/json
Creates the integration's routing rule, or replaces it entirely when one exists. At least one of cases or default must be provided.
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?