curl --request POST \
--url 'https://api.flashcat.cloud/safari/automation/rule/create?app_key=' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"name": "Weekly on-call review",
"team_id": 123,
"enabled": true,
"cron_expr": "0 9 * * 1",
"timezone": "Asia/Shanghai",
"schedule_trigger_enabled": true,
"prompt": "Summarize last week's alert noise and escalation load.",
"http_post_trigger_enabled": true,
"oncall_incident_trigger_enabled": true,
"oncall_incident_channel_ids": [
456
],
"oncall_incident_severities": [
"Critical",
"Warning"
]
}
EOFimport requests
url = "https://api.flashcat.cloud/safari/automation/rule/create?app_key="
payload = {
"name": "Weekly on-call review",
"team_id": 123,
"enabled": True,
"cron_expr": "0 9 * * 1",
"timezone": "Asia/Shanghai",
"schedule_trigger_enabled": True,
"prompt": "Summarize last week's alert noise and escalation load.",
"http_post_trigger_enabled": True,
"oncall_incident_trigger_enabled": True,
"oncall_incident_channel_ids": [456],
"oncall_incident_severities": ["Critical", "Warning"]
}
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({
name: 'Weekly on-call review',
team_id: 123,
enabled: true,
cron_expr: '0 9 * * 1',
timezone: 'Asia/Shanghai',
schedule_trigger_enabled: true,
prompt: 'Summarize last week\'s alert noise and escalation load.',
http_post_trigger_enabled: true,
oncall_incident_trigger_enabled: true,
oncall_incident_channel_ids: [456],
oncall_incident_severities: ['Critical', 'Warning']
})
};
fetch('https://api.flashcat.cloud/safari/automation/rule/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/safari/automation/rule/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([
'name' => 'Weekly on-call review',
'team_id' => 123,
'enabled' => true,
'cron_expr' => '0 9 * * 1',
'timezone' => 'Asia/Shanghai',
'schedule_trigger_enabled' => true,
'prompt' => 'Summarize last week\'s alert noise and escalation load.',
'http_post_trigger_enabled' => true,
'oncall_incident_trigger_enabled' => true,
'oncall_incident_channel_ids' => [
456
],
'oncall_incident_severities' => [
'Critical',
'Warning'
]
]),
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/safari/automation/rule/create?app_key="
payload := strings.NewReader("{\n \"name\": \"Weekly on-call review\",\n \"team_id\": 123,\n \"enabled\": true,\n \"cron_expr\": \"0 9 * * 1\",\n \"timezone\": \"Asia/Shanghai\",\n \"schedule_trigger_enabled\": true,\n \"prompt\": \"Summarize last week's alert noise and escalation load.\",\n \"http_post_trigger_enabled\": true,\n \"oncall_incident_trigger_enabled\": true,\n \"oncall_incident_channel_ids\": [\n 456\n ],\n \"oncall_incident_severities\": [\n \"Critical\",\n \"Warning\"\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/safari/automation/rule/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Weekly on-call review\",\n \"team_id\": 123,\n \"enabled\": true,\n \"cron_expr\": \"0 9 * * 1\",\n \"timezone\": \"Asia/Shanghai\",\n \"schedule_trigger_enabled\": true,\n \"prompt\": \"Summarize last week's alert noise and escalation load.\",\n \"http_post_trigger_enabled\": true,\n \"oncall_incident_trigger_enabled\": true,\n \"oncall_incident_channel_ids\": [\n 456\n ],\n \"oncall_incident_severities\": [\n \"Critical\",\n \"Warning\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/safari/automation/rule/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 \"name\": \"Weekly on-call review\",\n \"team_id\": 123,\n \"enabled\": true,\n \"cron_expr\": \"0 9 * * 1\",\n \"timezone\": \"Asia/Shanghai\",\n \"schedule_trigger_enabled\": true,\n \"prompt\": \"Summarize last week's alert noise and escalation load.\",\n \"http_post_trigger_enabled\": true,\n \"oncall_incident_trigger_enabled\": true,\n \"oncall_incident_channel_ids\": [\n 456\n ],\n \"oncall_incident_severities\": [\n \"Critical\",\n \"Warning\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"rule_id": "arule_7NnLzY2Qp8xS4kUaV3mR6b",
"account_id": 10023,
"team_id": 123,
"owner_id": 80011,
"name": "Weekly on-call review",
"enabled": true,
"run_scope": "team",
"cron_expr": "0 9 * * 1",
"timezone": "Asia/Shanghai",
"prompt": "Summarize last week's alert noise and escalation load.",
"environment_kind": "",
"environment_id": "",
"schedule_trigger_id": "atrig_6aKp3wT9mQ2xVc8bR1nY7z",
"schedule_trigger_enabled": true,
"http_post_trigger_id": "atrig_2bLq4xT8mP1sWd9cN3rF6y",
"http_post_trigger_url": "/safari/automation/triggers/atrig_2bLq4xT8mP1sWd9cN3rF6y/fire",
"http_post_trigger_enabled": true,
"can_edit": true,
"created_at": 1780367971228,
"updated_at": 1780367971228,
"http_post_token": "sat_yQ9p8V7n6M5k4J3h2G1f0E9d8C7b6A5z4Y3x2W1v0U",
"schedule_next_fire_at_ms": 1780630800000,
"oncall_incident_trigger_id": "atrig_9cVb2mN7qKs4dEa8T1rY5p",
"oncall_incident_trigger_enabled": true,
"oncall_incident_channel_ids": [
456
],
"oncall_incident_severities": [
"Critical",
"Warning"
],
"oncall_incident_merge_similar": true,
"war_room_trigger_enabled": false,
"execution_place": "web_console",
"execution_location": {
"place": "web_console",
"run_scope": "team",
"team_id": 123,
"description": "Web console"
}
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter skill_id 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."
}
}Create Automation rule
Create an Automation rule with schedule, HTTP POST, On-call incident, and war room triggers.
curl --request POST \
--url 'https://api.flashcat.cloud/safari/automation/rule/create?app_key=' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"name": "Weekly on-call review",
"team_id": 123,
"enabled": true,
"cron_expr": "0 9 * * 1",
"timezone": "Asia/Shanghai",
"schedule_trigger_enabled": true,
"prompt": "Summarize last week's alert noise and escalation load.",
"http_post_trigger_enabled": true,
"oncall_incident_trigger_enabled": true,
"oncall_incident_channel_ids": [
456
],
"oncall_incident_severities": [
"Critical",
"Warning"
]
}
EOFimport requests
url = "https://api.flashcat.cloud/safari/automation/rule/create?app_key="
payload = {
"name": "Weekly on-call review",
"team_id": 123,
"enabled": True,
"cron_expr": "0 9 * * 1",
"timezone": "Asia/Shanghai",
"schedule_trigger_enabled": True,
"prompt": "Summarize last week's alert noise and escalation load.",
"http_post_trigger_enabled": True,
"oncall_incident_trigger_enabled": True,
"oncall_incident_channel_ids": [456],
"oncall_incident_severities": ["Critical", "Warning"]
}
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({
name: 'Weekly on-call review',
team_id: 123,
enabled: true,
cron_expr: '0 9 * * 1',
timezone: 'Asia/Shanghai',
schedule_trigger_enabled: true,
prompt: 'Summarize last week\'s alert noise and escalation load.',
http_post_trigger_enabled: true,
oncall_incident_trigger_enabled: true,
oncall_incident_channel_ids: [456],
oncall_incident_severities: ['Critical', 'Warning']
})
};
fetch('https://api.flashcat.cloud/safari/automation/rule/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/safari/automation/rule/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([
'name' => 'Weekly on-call review',
'team_id' => 123,
'enabled' => true,
'cron_expr' => '0 9 * * 1',
'timezone' => 'Asia/Shanghai',
'schedule_trigger_enabled' => true,
'prompt' => 'Summarize last week\'s alert noise and escalation load.',
'http_post_trigger_enabled' => true,
'oncall_incident_trigger_enabled' => true,
'oncall_incident_channel_ids' => [
456
],
'oncall_incident_severities' => [
'Critical',
'Warning'
]
]),
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/safari/automation/rule/create?app_key="
payload := strings.NewReader("{\n \"name\": \"Weekly on-call review\",\n \"team_id\": 123,\n \"enabled\": true,\n \"cron_expr\": \"0 9 * * 1\",\n \"timezone\": \"Asia/Shanghai\",\n \"schedule_trigger_enabled\": true,\n \"prompt\": \"Summarize last week's alert noise and escalation load.\",\n \"http_post_trigger_enabled\": true,\n \"oncall_incident_trigger_enabled\": true,\n \"oncall_incident_channel_ids\": [\n 456\n ],\n \"oncall_incident_severities\": [\n \"Critical\",\n \"Warning\"\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/safari/automation/rule/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Weekly on-call review\",\n \"team_id\": 123,\n \"enabled\": true,\n \"cron_expr\": \"0 9 * * 1\",\n \"timezone\": \"Asia/Shanghai\",\n \"schedule_trigger_enabled\": true,\n \"prompt\": \"Summarize last week's alert noise and escalation load.\",\n \"http_post_trigger_enabled\": true,\n \"oncall_incident_trigger_enabled\": true,\n \"oncall_incident_channel_ids\": [\n 456\n ],\n \"oncall_incident_severities\": [\n \"Critical\",\n \"Warning\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/safari/automation/rule/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 \"name\": \"Weekly on-call review\",\n \"team_id\": 123,\n \"enabled\": true,\n \"cron_expr\": \"0 9 * * 1\",\n \"timezone\": \"Asia/Shanghai\",\n \"schedule_trigger_enabled\": true,\n \"prompt\": \"Summarize last week's alert noise and escalation load.\",\n \"http_post_trigger_enabled\": true,\n \"oncall_incident_trigger_enabled\": true,\n \"oncall_incident_channel_ids\": [\n 456\n ],\n \"oncall_incident_severities\": [\n \"Critical\",\n \"Warning\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"rule_id": "arule_7NnLzY2Qp8xS4kUaV3mR6b",
"account_id": 10023,
"team_id": 123,
"owner_id": 80011,
"name": "Weekly on-call review",
"enabled": true,
"run_scope": "team",
"cron_expr": "0 9 * * 1",
"timezone": "Asia/Shanghai",
"prompt": "Summarize last week's alert noise and escalation load.",
"environment_kind": "",
"environment_id": "",
"schedule_trigger_id": "atrig_6aKp3wT9mQ2xVc8bR1nY7z",
"schedule_trigger_enabled": true,
"http_post_trigger_id": "atrig_2bLq4xT8mP1sWd9cN3rF6y",
"http_post_trigger_url": "/safari/automation/triggers/atrig_2bLq4xT8mP1sWd9cN3rF6y/fire",
"http_post_trigger_enabled": true,
"can_edit": true,
"created_at": 1780367971228,
"updated_at": 1780367971228,
"http_post_token": "sat_yQ9p8V7n6M5k4J3h2G1f0E9d8C7b6A5z4Y3x2W1v0U",
"schedule_next_fire_at_ms": 1780630800000,
"oncall_incident_trigger_id": "atrig_9cVb2mN7qKs4dEa8T1rY5p",
"oncall_incident_trigger_enabled": true,
"oncall_incident_channel_ids": [
456
],
"oncall_incident_severities": [
"Critical",
"Warning"
],
"oncall_incident_merge_similar": true,
"war_room_trigger_enabled": false,
"execution_place": "web_console",
"execution_location": {
"place": "web_console",
"run_scope": "team",
"team_id": 123,
"description": "Web console"
}
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter skill_id 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 | 300 requests/minute; 20 requests/second per account |
| Permissions | Automation Manage (ai-sre) |
Usage
- Send
0for a personal rule. An app key that omitsteam_idalso gets a personal rule. A team rule requires the caller to be a member of that team; account owners and admins get no exemption. - A rule’s scope is fixed at creation: Update Automation rule rejects any
team_idthat differs from the stored value. Create a new rule to run the same task under another scope. cron_expris required even when only other triggers are used; send a valid expression withschedule_trigger_enabled=false.cron_expris evaluated intimezoneif provided, else the caller’s member timezone, else the account timezone, elseAsia/Shanghai.http_post_trigger_enabled=truecreates an enabled HTTP POST trigger.http_post_tokenis returned only in this response; save it. Fire the trigger withPOSTtohttp_post_trigger_urland the headerAuthorization: Bearer <http_post_token>; the optional JSON body{"text": "..."}is limited to 256 KB.- If any
oncall_incident_*field is sent, bothoncall_incident_channel_idsandoncall_incident_severitiesmust be non-empty. Matching incidents start runs withtrigger_kind=oncall_incident. - If
war_room_trigger_enabled=trueorwar_room_channel_idsis sent, bothwar_room_channel_idsandwar_room_severitiesmust be non-empty. When a war room (IM group chat) is created for a matching incident, the agent runs inside that group chat and the run hastrigger_kind=war_room_created. - Runs started through the API execute in the web console (
execution_place=web_console);run_in=current-chatis accepted only from a live IM conversation with the AI SRE agent and is rejected here. - The response is the created rule;
can_editis alwaystruefor the creator. - Every call is recorded in the account audit log.
Authorizations
Body
Create an Automation rule.
Schedule in local time of timezone. Accepts 4 fields (hour day month weekday, minute defaults to 0) or 5 fields (minute hour day month weekday). The minute must be one fixed integer; seconds (6 fields) are not supported; setting both day-of-month and day-of-week is rejected. Required even for rules that use only other triggers: send a valid expression with schedule_trigger_enabled=false.
"15 9 * * *"
Scope of the rule. 0: a personal rule owned by the caller. >0: a team rule; the caller must be a member of that team. Omitted: a personal rule for an app key; a rule created by the AI SRE agent inherits its session's scope. The scope cannot be changed after creation.
x >= 0Runtime environment kind. Omit or send an empty value for automatic selection. One of: cloud (platform-hosted cloud sandbox), byoc (a self-hosted BYOC runner in the account, used with environment_id); automatic selection prefers an online BYOC runner and falls back to the cloud sandbox.
, cloud, byoc Whether to merge similar incidents into one analysis. When true (default), an incident that closely resembles one already being analyzed by this rule (a run in progress or finished within the last 10 minutes) joins that run's session instead of starting a new one; its own run is recorded as skipped with joined_session_id set. When false, every matching incident starts its own run.
Whether the war room trigger is enabled. It fires when a war room (IM group chat) is created for an incident in one of war_room_channel_ids with a severity in war_room_severities; the agent then runs inside that group chat. When the trigger is created (this is true, or war_room_channel_ids is sent), both lists must be non-empty.
Response
Success
Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.
Was this page helpful?