curl --request POST \
--url 'https://api.flashcat.cloud/monit/store/ruleset/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"type_ident": "prometheus",
"note": "CPU usage alerts",
"open_flag": 1,
"payload": "[{\"prom_ql\":\"rate(cpu_usage[5m]) > 0.8\"}]"
}
'import requests
url = "https://api.flashcat.cloud/monit/store/ruleset/create?app_key="
payload = {
"type_ident": "prometheus",
"note": "CPU usage alerts",
"open_flag": 1,
"payload": "[{\"prom_ql\":\"rate(cpu_usage[5m]) > 0.8\"}]"
}
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({
type_ident: 'prometheus',
note: 'CPU usage alerts',
open_flag: 1,
payload: '[{"prom_ql":"rate(cpu_usage[5m]) > 0.8"}]'
})
};
fetch('https://api.flashcat.cloud/monit/store/ruleset/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/monit/store/ruleset/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([
'type_ident' => 'prometheus',
'note' => 'CPU usage alerts',
'open_flag' => 1,
'payload' => '[{"prom_ql":"rate(cpu_usage[5m]) > 0.8"}]'
]),
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/store/ruleset/create?app_key="
payload := strings.NewReader("{\n \"type_ident\": \"prometheus\",\n \"note\": \"CPU usage alerts\",\n \"open_flag\": 1,\n \"payload\": \"[{\\\"prom_ql\\\":\\\"rate(cpu_usage[5m]) > 0.8\\\"}]\"\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/store/ruleset/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"type_ident\": \"prometheus\",\n \"note\": \"CPU usage alerts\",\n \"open_flag\": 1,\n \"payload\": \"[{\\\"prom_ql\\\":\\\"rate(cpu_usage[5m]) > 0.8\\\"}]\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/monit/store/ruleset/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 \"type_ident\": \"prometheus\",\n \"note\": \"CPU usage alerts\",\n \"open_flag\": 1,\n \"payload\": \"[{\\\"prom_ql\\\":\\\"rate(cpu_usage[5m]) > 0.8\\\"}]\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"id": 1,
"type_ident": "prometheus",
"note": "CPU usage alerts",
"open_flag": 1,
"created_at": 1712000000,
"updated_at": 1712000000
}
}{
"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 ruleset
Create a new ruleset in the rule repository.
curl --request POST \
--url 'https://api.flashcat.cloud/monit/store/ruleset/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"type_ident": "prometheus",
"note": "CPU usage alerts",
"open_flag": 1,
"payload": "[{\"prom_ql\":\"rate(cpu_usage[5m]) > 0.8\"}]"
}
'import requests
url = "https://api.flashcat.cloud/monit/store/ruleset/create?app_key="
payload = {
"type_ident": "prometheus",
"note": "CPU usage alerts",
"open_flag": 1,
"payload": "[{\"prom_ql\":\"rate(cpu_usage[5m]) > 0.8\"}]"
}
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({
type_ident: 'prometheus',
note: 'CPU usage alerts',
open_flag: 1,
payload: '[{"prom_ql":"rate(cpu_usage[5m]) > 0.8"}]'
})
};
fetch('https://api.flashcat.cloud/monit/store/ruleset/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/monit/store/ruleset/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([
'type_ident' => 'prometheus',
'note' => 'CPU usage alerts',
'open_flag' => 1,
'payload' => '[{"prom_ql":"rate(cpu_usage[5m]) > 0.8"}]'
]),
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/store/ruleset/create?app_key="
payload := strings.NewReader("{\n \"type_ident\": \"prometheus\",\n \"note\": \"CPU usage alerts\",\n \"open_flag\": 1,\n \"payload\": \"[{\\\"prom_ql\\\":\\\"rate(cpu_usage[5m]) > 0.8\\\"}]\"\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/store/ruleset/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"type_ident\": \"prometheus\",\n \"note\": \"CPU usage alerts\",\n \"open_flag\": 1,\n \"payload\": \"[{\\\"prom_ql\\\":\\\"rate(cpu_usage[5m]) > 0.8\\\"}]\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/monit/store/ruleset/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 \"type_ident\": \"prometheus\",\n \"note\": \"CPU usage alerts\",\n \"open_flag\": 1,\n \"payload\": \"[{\\\"prom_ql\\\":\\\"rate(cpu_usage[5m]) > 0.8\\\"}]\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"id": 1,
"type_ident": "prometheus",
"note": "CPU usage alerts",
"open_flag": 1,
"created_at": 1712000000,
"updated_at": 1712000000
}
}{
"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 | Rule Repository Manage (monit) |
Usage
open_flag:0= private (creator only),1= account-shared,2= public.payloadis a required JSON string containing the alert rule definitions.- 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
Request body for creating a ruleset. All fields are validated by Validate() on the server.
Datasource type identifier this ruleset applies to, e.g. prometheus.
Description or title of the ruleset.
JSON string containing the alert rule definitions.
Sharing scope. 0 = private (creator only), 1 = account-shared, 2 = public. Defaults to 0 if omitted.
0, 1, 2 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?