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",
"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."
}
}Upsert routing rule
Create or update routing rules for an integration to direct alerts to specific channels. At least one of cases or default must be provided.
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",
"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 | Integrations 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 or updating the routing rule of an integration. The handler creates a rule when none exists for the integration, otherwise it overwrites the existing one. At least one of cases or default must be provided.
Integration the rule belongs to.
Ordered list of case branches. Cases are evaluated top to bottom.
Show child attributes
Show child attributes
Optional sections that group consecutive cases for display.
Show child attributes
Show child attributes
Default branch used when no case matches (or all matched cases yield no valid channels).
Show child attributes
Show child attributes
Expected current version for optimistic concurrency control. Pass the value returned by the latest read.
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?