curl --request POST \
--url 'https://api.flashcat.cloud/monit/folder/list?app_key=' \
--header 'Content-Type: application/json' \
--data '{
"scope": "all"
}'import requests
url = "https://api.flashcat.cloud/monit/folder/list?app_key="
payload = { "scope": "all" }
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({scope: 'all'})
};
fetch('https://api.flashcat.cloud/monit/folder/list?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/folder/list?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([
'scope' => 'all'
]),
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/folder/list?app_key="
payload := strings.NewReader("{\n \"scope\": \"all\"\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/folder/list?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"scope\": \"all\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/monit/folder/list?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 \"scope\": \"all\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": [
{
"id": 12,
"account_id": 10023,
"parent_id": 10,
"parent_path": "10",
"team_id": 0,
"name": "Checkout",
"note": "Checkout service folders",
"creator_id": 10023,
"creator_name": "Ada Lovelace",
"updater_id": 10088,
"updater_name": "Grace Hopper",
"created_at": 1791000000,
"updated_at": 1791100800,
"writable": true
}
]
}{
"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."
}
}List monitor folders
List the monitor folders in the requested scope.
curl --request POST \
--url 'https://api.flashcat.cloud/monit/folder/list?app_key=' \
--header 'Content-Type: application/json' \
--data '{
"scope": "all"
}'import requests
url = "https://api.flashcat.cloud/monit/folder/list?app_key="
payload = { "scope": "all" }
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({scope: 'all'})
};
fetch('https://api.flashcat.cloud/monit/folder/list?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/folder/list?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([
'scope' => 'all'
]),
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/folder/list?app_key="
payload := strings.NewReader("{\n \"scope\": \"all\"\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/folder/list?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"scope\": \"all\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/monit/folder/list?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 \"scope\": \"all\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": [
{
"id": 12,
"account_id": 10023,
"parent_id": 10,
"parent_path": "10",
"team_id": 0,
"name": "Checkout",
"note": "Checkout service folders",
"creator_id": 10023,
"creator_name": "Ada Lovelace",
"updater_id": 10088,
"updater_name": "Grace Hopper",
"created_at": 1791000000,
"updated_at": 1791100800,
"writable": true
}
]
}{
"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 | 1,000 requests/minute; 50 requests/second per account |
| Permissions | Alerting Rules Read, Alerting Rules Manage, Node Permissions Read, or Node Permissions Manage (monit) |
Usage
- The response is a flat list of the folders in the requested scope, not a tree: rebuild the hierarchy from
parent_idandparent_path, and search client-side. An account with no visible folder gets[]. scopepicks the set. Whenscopeis omitted, account owners, admins and roles with the all-teams view scope getall, and other members getmine.mineis the folders your teams own and the folders you created, everything below them, and the ancestor folders needed to reach them;allis every folder of the account. The scope only filters the view — it no longer limits what you may read.writablecarries the folder grant alone (team member, folder creator, account owner or admin); the APP Key’s role permissions are checked separately, so combine both before offering an edit action.- Dashboards and alert rules both live in this folder tree, so the same IDs appear as
folder_idon dashboard payloads and alert rules.
Authorizations
Body
Optional read scope for folder-based listings. An empty request body is the same as omitting scope.
Which folders the response covers. mine covers the folders of the caller's teams and the folders the caller created, plus their descendants; all covers every folder of the account. When omitted, it is all for account owners, admins and roles with the all-teams view scope, and mine for other members. Any other value fails with InvalidParameter.
mine, all 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?