curl --request POST \
--url 'https://api.flashcat.cloud/rum/error-ingestion/rules/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"application_id": "WoyQQ3BohkdtPivubEvE8o",
"rule_name": "Production console errors",
"description": "Only ingest TypeError/ReferenceError from production, excluding Safari.",
"filters": [
[
{
"key": "error.env",
"oper": "IN",
"vals": [
"production"
]
},
{
"key": "error.error_type",
"oper": "IN",
"vals": [
"TypeError",
"ReferenceError"
]
}
],
[
{
"key": "error.browser_name",
"oper": "NOTIN",
"vals": [
"Safari"
]
}
]
]
}
'import requests
url = "https://api.flashcat.cloud/rum/error-ingestion/rules/create?app_key="
payload = {
"application_id": "WoyQQ3BohkdtPivubEvE8o",
"rule_name": "Production console errors",
"description": "Only ingest TypeError/ReferenceError from production, excluding Safari.",
"filters": [[
{
"key": "error.env",
"oper": "IN",
"vals": ["production"]
},
{
"key": "error.error_type",
"oper": "IN",
"vals": ["TypeError", "ReferenceError"]
}
], [
{
"key": "error.browser_name",
"oper": "NOTIN",
"vals": ["Safari"]
}
]]
}
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({
application_id: 'WoyQQ3BohkdtPivubEvE8o',
rule_name: 'Production console errors',
description: 'Only ingest TypeError/ReferenceError from production, excluding Safari.',
filters: [
[
{key: 'error.env', oper: 'IN', vals: ['production']},
{key: 'error.error_type', oper: 'IN', vals: ['TypeError', 'ReferenceError']}
],
[{key: 'error.browser_name', oper: 'NOTIN', vals: ['Safari']}]
]
})
};
fetch('https://api.flashcat.cloud/rum/error-ingestion/rules/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/rum/error-ingestion/rules/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([
'application_id' => 'WoyQQ3BohkdtPivubEvE8o',
'rule_name' => 'Production console errors',
'description' => 'Only ingest TypeError/ReferenceError from production, excluding Safari.',
'filters' => [
[
[
'key' => 'error.env',
'oper' => 'IN',
'vals' => [
'production'
]
],
[
'key' => 'error.error_type',
'oper' => 'IN',
'vals' => [
'TypeError',
'ReferenceError'
]
]
],
[
[
'key' => 'error.browser_name',
'oper' => 'NOTIN',
'vals' => [
'Safari'
]
]
]
]
]),
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/rum/error-ingestion/rules/create?app_key="
payload := strings.NewReader("{\n \"application_id\": \"WoyQQ3BohkdtPivubEvE8o\",\n \"rule_name\": \"Production console errors\",\n \"description\": \"Only ingest TypeError/ReferenceError from production, excluding Safari.\",\n \"filters\": [\n [\n {\n \"key\": \"error.env\",\n \"oper\": \"IN\",\n \"vals\": [\n \"production\"\n ]\n },\n {\n \"key\": \"error.error_type\",\n \"oper\": \"IN\",\n \"vals\": [\n \"TypeError\",\n \"ReferenceError\"\n ]\n }\n ],\n [\n {\n \"key\": \"error.browser_name\",\n \"oper\": \"NOTIN\",\n \"vals\": [\n \"Safari\"\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/rum/error-ingestion/rules/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"application_id\": \"WoyQQ3BohkdtPivubEvE8o\",\n \"rule_name\": \"Production console errors\",\n \"description\": \"Only ingest TypeError/ReferenceError from production, excluding Safari.\",\n \"filters\": [\n [\n {\n \"key\": \"error.env\",\n \"oper\": \"IN\",\n \"vals\": [\n \"production\"\n ]\n },\n {\n \"key\": \"error.error_type\",\n \"oper\": \"IN\",\n \"vals\": [\n \"TypeError\",\n \"ReferenceError\"\n ]\n }\n ],\n [\n {\n \"key\": \"error.browser_name\",\n \"oper\": \"NOTIN\",\n \"vals\": [\n \"Safari\"\n ]\n }\n ]\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/rum/error-ingestion/rules/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 \"application_id\": \"WoyQQ3BohkdtPivubEvE8o\",\n \"rule_name\": \"Production console errors\",\n \"description\": \"Only ingest TypeError/ReferenceError from production, excluding Safari.\",\n \"filters\": [\n [\n {\n \"key\": \"error.env\",\n \"oper\": \"IN\",\n \"vals\": [\n \"production\"\n ]\n },\n {\n \"key\": \"error.error_type\",\n \"oper\": \"IN\",\n \"vals\": [\n \"TypeError\",\n \"ReferenceError\"\n ]\n }\n ],\n [\n {\n \"key\": \"error.browser_name\",\n \"oper\": \"NOTIN\",\n \"vals\": [\n \"Safari\"\n ]\n }\n ]\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"rule_id": "9spXEVoMeZWujjz25yrgTe",
"rule_name": "Production console errors"
}
}{
"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 an error ingestion rule
Create a new error ingestion rule that filters which errors are stored.
curl --request POST \
--url 'https://api.flashcat.cloud/rum/error-ingestion/rules/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"application_id": "WoyQQ3BohkdtPivubEvE8o",
"rule_name": "Production console errors",
"description": "Only ingest TypeError/ReferenceError from production, excluding Safari.",
"filters": [
[
{
"key": "error.env",
"oper": "IN",
"vals": [
"production"
]
},
{
"key": "error.error_type",
"oper": "IN",
"vals": [
"TypeError",
"ReferenceError"
]
}
],
[
{
"key": "error.browser_name",
"oper": "NOTIN",
"vals": [
"Safari"
]
}
]
]
}
'import requests
url = "https://api.flashcat.cloud/rum/error-ingestion/rules/create?app_key="
payload = {
"application_id": "WoyQQ3BohkdtPivubEvE8o",
"rule_name": "Production console errors",
"description": "Only ingest TypeError/ReferenceError from production, excluding Safari.",
"filters": [[
{
"key": "error.env",
"oper": "IN",
"vals": ["production"]
},
{
"key": "error.error_type",
"oper": "IN",
"vals": ["TypeError", "ReferenceError"]
}
], [
{
"key": "error.browser_name",
"oper": "NOTIN",
"vals": ["Safari"]
}
]]
}
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({
application_id: 'WoyQQ3BohkdtPivubEvE8o',
rule_name: 'Production console errors',
description: 'Only ingest TypeError/ReferenceError from production, excluding Safari.',
filters: [
[
{key: 'error.env', oper: 'IN', vals: ['production']},
{key: 'error.error_type', oper: 'IN', vals: ['TypeError', 'ReferenceError']}
],
[{key: 'error.browser_name', oper: 'NOTIN', vals: ['Safari']}]
]
})
};
fetch('https://api.flashcat.cloud/rum/error-ingestion/rules/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/rum/error-ingestion/rules/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([
'application_id' => 'WoyQQ3BohkdtPivubEvE8o',
'rule_name' => 'Production console errors',
'description' => 'Only ingest TypeError/ReferenceError from production, excluding Safari.',
'filters' => [
[
[
'key' => 'error.env',
'oper' => 'IN',
'vals' => [
'production'
]
],
[
'key' => 'error.error_type',
'oper' => 'IN',
'vals' => [
'TypeError',
'ReferenceError'
]
]
],
[
[
'key' => 'error.browser_name',
'oper' => 'NOTIN',
'vals' => [
'Safari'
]
]
]
]
]),
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/rum/error-ingestion/rules/create?app_key="
payload := strings.NewReader("{\n \"application_id\": \"WoyQQ3BohkdtPivubEvE8o\",\n \"rule_name\": \"Production console errors\",\n \"description\": \"Only ingest TypeError/ReferenceError from production, excluding Safari.\",\n \"filters\": [\n [\n {\n \"key\": \"error.env\",\n \"oper\": \"IN\",\n \"vals\": [\n \"production\"\n ]\n },\n {\n \"key\": \"error.error_type\",\n \"oper\": \"IN\",\n \"vals\": [\n \"TypeError\",\n \"ReferenceError\"\n ]\n }\n ],\n [\n {\n \"key\": \"error.browser_name\",\n \"oper\": \"NOTIN\",\n \"vals\": [\n \"Safari\"\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/rum/error-ingestion/rules/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"application_id\": \"WoyQQ3BohkdtPivubEvE8o\",\n \"rule_name\": \"Production console errors\",\n \"description\": \"Only ingest TypeError/ReferenceError from production, excluding Safari.\",\n \"filters\": [\n [\n {\n \"key\": \"error.env\",\n \"oper\": \"IN\",\n \"vals\": [\n \"production\"\n ]\n },\n {\n \"key\": \"error.error_type\",\n \"oper\": \"IN\",\n \"vals\": [\n \"TypeError\",\n \"ReferenceError\"\n ]\n }\n ],\n [\n {\n \"key\": \"error.browser_name\",\n \"oper\": \"NOTIN\",\n \"vals\": [\n \"Safari\"\n ]\n }\n ]\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/rum/error-ingestion/rules/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 \"application_id\": \"WoyQQ3BohkdtPivubEvE8o\",\n \"rule_name\": \"Production console errors\",\n \"description\": \"Only ingest TypeError/ReferenceError from production, excluding Safari.\",\n \"filters\": [\n [\n {\n \"key\": \"error.env\",\n \"oper\": \"IN\",\n \"vals\": [\n \"production\"\n ]\n },\n {\n \"key\": \"error.error_type\",\n \"oper\": \"IN\",\n \"vals\": [\n \"TypeError\",\n \"ReferenceError\"\n ]\n }\n ],\n [\n {\n \"key\": \"error.browser_name\",\n \"oper\": \"NOTIN\",\n \"vals\": [\n \"Safari\"\n ]\n }\n ]\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"rule_id": "9spXEVoMeZWujjz25yrgTe",
"rule_name": "Production console errors"
}
}{
"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 | 300 requests/minute; 20 requests/second per account |
| Permissions | None — any valid app_key can call this operation |
Usage
- Create, update, enable, disable, and delete all snapshot the application’s full current rule set into history first, so
history/listreflects every mutation. - Every condition key in
filtersmust be one of the supportederror.*fields or acontext.*path; unsupported keys are rejected withInvalidParameter. - New rules are created with status
enabled; calldisableafterward if the rule should start inactive. - Every call is recorded in the account audit log. Don’t put secrets in request fields.
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
Fields for creating a new error ingestion rule.
RUM application ID. Get application IDs via POST /rum/application/list.
Rule name, 1-128 characters.
1 - 128Filter conditions (OR-of-ANDs) to match errors; matched errors are dropped and not ingested.
AND-group. The group only matches when every condition inside it matches.
Show child attributes
Show child attributes
Rule description, up to 512 characters.
512Response
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?