curl --request POST \
--url 'https://api.flashcat.cloud/monit/rule/import?app_key=' \
--header 'Content-Type: application/json' \
--data '
[
{
"folder_id": 100,
"name": "CPU High",
"ds_type": "prometheus",
"ds_list": [
"prometheus*"
],
"enabled": true,
"cron_pattern": "0 * * * * *",
"rule_configs": {
"queries": [
{
"name": "A",
"expr": "avg(cpu_usage_idle) < 10"
}
]
}
}
]
'import requests
url = "https://api.flashcat.cloud/monit/rule/import?app_key="
payload = [
{
"folder_id": 100,
"name": "CPU High",
"ds_type": "prometheus",
"ds_list": ["prometheus*"],
"enabled": True,
"cron_pattern": "0 * * * * *",
"rule_configs": { "queries": [
{
"name": "A",
"expr": "avg(cpu_usage_idle) < 10"
}
] }
}
]
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([
{
folder_id: 100,
name: 'CPU High',
ds_type: 'prometheus',
ds_list: ['prometheus*'],
enabled: true,
cron_pattern: '0 * * * * *',
rule_configs: {queries: [{name: 'A', expr: 'avg(cpu_usage_idle) < 10'}]}
}
])
};
fetch('https://api.flashcat.cloud/monit/rule/import?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/monit/rule/import?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([
[
'folder_id' => 100,
'name' => 'CPU High',
'ds_type' => 'prometheus',
'ds_list' => [
'prometheus*'
],
'enabled' => true,
'cron_pattern' => '0 * * * * *',
'rule_configs' => [
'queries' => [
[
'name' => 'A',
'expr' => 'avg(cpu_usage_idle) < 10'
]
]
]
]
]),
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/monit/rule/import?app_key="
payload := strings.NewReader("[\n {\n \"folder_id\": 100,\n \"name\": \"CPU High\",\n \"ds_type\": \"prometheus\",\n \"ds_list\": [\n \"prometheus*\"\n ],\n \"enabled\": true,\n \"cron_pattern\": \"0 * * * * *\",\n \"rule_configs\": {\n \"queries\": [\n {\n \"name\": \"A\",\n \"expr\": \"avg(cpu_usage_idle) < 10\"\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/monit/rule/import?app_key=")
.header("Content-Type", "application/json")
.body("[\n {\n \"folder_id\": 100,\n \"name\": \"CPU High\",\n \"ds_type\": \"prometheus\",\n \"ds_list\": [\n \"prometheus*\"\n ],\n \"enabled\": true,\n \"cron_pattern\": \"0 * * * * *\",\n \"rule_configs\": {\n \"queries\": [\n {\n \"name\": \"A\",\n \"expr\": \"avg(cpu_usage_idle) < 10\"\n }\n ]\n }\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/monit/rule/import?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 {\n \"folder_id\": 100,\n \"name\": \"CPU High\",\n \"ds_type\": \"prometheus\",\n \"ds_list\": [\n \"prometheus*\"\n ],\n \"enabled\": true,\n \"cron_pattern\": \"0 * * * * *\",\n \"rule_configs\": {\n \"queries\": [\n {\n \"name\": \"A\",\n \"expr\": \"avg(cpu_usage_idle) < 10\"\n }\n ]\n }\n }\n]"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": [
{
"name": "CPU High",
"message": ""
}
]
}{
"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."
}
}Import alert rules
Import one or more alert rules from a JSON array. Returns the result for each rule, indicating success or failure.
curl --request POST \
--url 'https://api.flashcat.cloud/monit/rule/import?app_key=' \
--header 'Content-Type: application/json' \
--data '
[
{
"folder_id": 100,
"name": "CPU High",
"ds_type": "prometheus",
"ds_list": [
"prometheus*"
],
"enabled": true,
"cron_pattern": "0 * * * * *",
"rule_configs": {
"queries": [
{
"name": "A",
"expr": "avg(cpu_usage_idle) < 10"
}
]
}
}
]
'import requests
url = "https://api.flashcat.cloud/monit/rule/import?app_key="
payload = [
{
"folder_id": 100,
"name": "CPU High",
"ds_type": "prometheus",
"ds_list": ["prometheus*"],
"enabled": True,
"cron_pattern": "0 * * * * *",
"rule_configs": { "queries": [
{
"name": "A",
"expr": "avg(cpu_usage_idle) < 10"
}
] }
}
]
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([
{
folder_id: 100,
name: 'CPU High',
ds_type: 'prometheus',
ds_list: ['prometheus*'],
enabled: true,
cron_pattern: '0 * * * * *',
rule_configs: {queries: [{name: 'A', expr: 'avg(cpu_usage_idle) < 10'}]}
}
])
};
fetch('https://api.flashcat.cloud/monit/rule/import?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/monit/rule/import?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([
[
'folder_id' => 100,
'name' => 'CPU High',
'ds_type' => 'prometheus',
'ds_list' => [
'prometheus*'
],
'enabled' => true,
'cron_pattern' => '0 * * * * *',
'rule_configs' => [
'queries' => [
[
'name' => 'A',
'expr' => 'avg(cpu_usage_idle) < 10'
]
]
]
]
]),
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/monit/rule/import?app_key="
payload := strings.NewReader("[\n {\n \"folder_id\": 100,\n \"name\": \"CPU High\",\n \"ds_type\": \"prometheus\",\n \"ds_list\": [\n \"prometheus*\"\n ],\n \"enabled\": true,\n \"cron_pattern\": \"0 * * * * *\",\n \"rule_configs\": {\n \"queries\": [\n {\n \"name\": \"A\",\n \"expr\": \"avg(cpu_usage_idle) < 10\"\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/monit/rule/import?app_key=")
.header("Content-Type", "application/json")
.body("[\n {\n \"folder_id\": 100,\n \"name\": \"CPU High\",\n \"ds_type\": \"prometheus\",\n \"ds_list\": [\n \"prometheus*\"\n ],\n \"enabled\": true,\n \"cron_pattern\": \"0 * * * * *\",\n \"rule_configs\": {\n \"queries\": [\n {\n \"name\": \"A\",\n \"expr\": \"avg(cpu_usage_idle) < 10\"\n }\n ]\n }\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/monit/rule/import?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 {\n \"folder_id\": 100,\n \"name\": \"CPU High\",\n \"ds_type\": \"prometheus\",\n \"ds_list\": [\n \"prometheus*\"\n ],\n \"enabled\": true,\n \"cron_pattern\": \"0 * * * * *\",\n \"rule_configs\": {\n \"queries\": [\n {\n \"name\": \"A\",\n \"expr\": \"avg(cpu_usage_idle) < 10\"\n }\n ]\n }\n }\n]"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": [
{
"name": "CPU High",
"message": ""
}
]
}{
"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 | 20 requests/minute; 2 requests/second per account |
| Permissions | Alerting Rules Manage (monit) |
Usage
- The request body is a JSON array of rule export objects (compatible with the output of
POST /monit/rule/export). - Each object must include
folder_id,ds_type, and eitherds_listords_ids. - Some rules may fail (e.g. duplicate name). Check each result for individual status.
- 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
ID of the folder the rule belongs to. Obtainable via POST /monit/folder/list.
Rule name. Must be unique within the same folder.
Datasource type identifier (e.g. prometheus, elasticsearch).
Check configuration: query list plus trigger/recovery conditions. Structure see RuleConfigs.
Show child attributes
Show child attributes
Schedule expression: a 6-field cron (with seconds) or an @every 30s interval descriptor. Must not start with CRON_TZ= or TZ=; use the timezone field instead.
Rule ID. Required for update; omit for create (assigned by the server).
Account ID. Filled by the server from the authenticated identity; do not provide.
Custom labels.
Show child attributes
Show child attributes
Data source name patterns (supports wildcards). At least one of ds_list / ds_ids must be non-empty; the two are merged to decide which datasources the rule monitors.
Datasource IDs, merged with ds_list to decide which datasources the rule monitors; IDs survive datasource renames. At least one of ds_list and ds_ids must be provided.
Whether the rule is enabled. Updating to false makes the server clean up the rule's active alerts.
Whether to enable debug logging; the edge emits detailed evaluation logs, useful for troubleshooting rules that do not trigger as expected.
Timezone in which the rule executes. Determines how the cron schedule and effective time windows are interpreted. Only IANA timezone names are accepted (e.g. Asia/Shanghai, UTC, Europe/London); shortcuts and offsets such as Local, UTC+8, or CST are rejected. Treated as Asia/Shanghai if empty.
Seconds to shift the evaluation query window backward, compensating for data ingestion latency.
Time windows when the rule is active. Defaults to all days from 00:00 to 23:59 when omitted or empty.
Show child attributes
Show child attributes
Annotation key-value pairs delivered with alert events; keys must not start with $ (reserved for query fields).
Show child attributes
Show child attributes
Format for the description. Defaults to text when omitted or empty. text = plain text; markdown = Markdown, rendered as Markdown in alert details.
text, markdown Rule description, in Markdown.
Channel IDs to send alerts to.
Notification repeat interval in seconds.
Max number of repeat notifications.
Creator user ID. Filled by the server from the current user; do not provide.
Creator name. Filled by the server; do not provide.
Last updater user ID. Filled by the server; do not provide.
Last updater name. Filled by the server; do not provide.
Creation time as a Unix timestamp in seconds. Generated by the server; do not provide.
Last update time as a Unix timestamp in seconds. Generated by the server; do not provide.
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?