curl --request POST \
--url 'https://api.flashcat.cloud/alert/merge?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"alert_ids": [
"663a1b2c3d4e5f6789abcdef"
],
"incident_id": "663a000000000000deadbeef"
}
'import requests
url = "https://api.flashcat.cloud/alert/merge?app_key="
payload = {
"alert_ids": ["663a1b2c3d4e5f6789abcdef"],
"incident_id": "663a000000000000deadbeef"
}
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({
alert_ids: ['663a1b2c3d4e5f6789abcdef'],
incident_id: '663a000000000000deadbeef'
})
};
fetch('https://api.flashcat.cloud/alert/merge?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/alert/merge?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([
'alert_ids' => [
'663a1b2c3d4e5f6789abcdef'
],
'incident_id' => '663a000000000000deadbeef'
]),
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/alert/merge?app_key="
payload := strings.NewReader("{\n \"alert_ids\": [\n \"663a1b2c3d4e5f6789abcdef\"\n ],\n \"incident_id\": \"663a000000000000deadbeef\"\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/alert/merge?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"alert_ids\": [\n \"663a1b2c3d4e5f6789abcdef\"\n ],\n \"incident_id\": \"663a000000000000deadbeef\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/alert/merge?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 \"alert_ids\": [\n \"663a1b2c3d4e5f6789abcdef\"\n ],\n \"incident_id\": \"663a000000000000deadbeef\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {}
}{
"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."
}
}Merge alerts into an incident
Associate one or more alerts with an existing incident. If a source alert previously belonged to a different incident and that incident becomes empty after the merge, it will be automatically closed.
curl --request POST \
--url 'https://api.flashcat.cloud/alert/merge?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"alert_ids": [
"663a1b2c3d4e5f6789abcdef"
],
"incident_id": "663a000000000000deadbeef"
}
'import requests
url = "https://api.flashcat.cloud/alert/merge?app_key="
payload = {
"alert_ids": ["663a1b2c3d4e5f6789abcdef"],
"incident_id": "663a000000000000deadbeef"
}
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({
alert_ids: ['663a1b2c3d4e5f6789abcdef'],
incident_id: '663a000000000000deadbeef'
})
};
fetch('https://api.flashcat.cloud/alert/merge?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/alert/merge?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([
'alert_ids' => [
'663a1b2c3d4e5f6789abcdef'
],
'incident_id' => '663a000000000000deadbeef'
]),
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/alert/merge?app_key="
payload := strings.NewReader("{\n \"alert_ids\": [\n \"663a1b2c3d4e5f6789abcdef\"\n ],\n \"incident_id\": \"663a000000000000deadbeef\"\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/alert/merge?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"alert_ids\": [\n \"663a1b2c3d4e5f6789abcdef\"\n ],\n \"incident_id\": \"663a000000000000deadbeef\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/alert/merge?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 \"alert_ids\": [\n \"663a1b2c3d4e5f6789abcdef\"\n ],\n \"incident_id\": \"663a000000000000deadbeef\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {}
}{
"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 | Channels Read (on-call) |
Usage
- All
alert_idsand theincident_idmust belong to the caller’s account. - Optionally set
titleandowner_idto update the target incident at the same time.
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
Alert IDs to merge (ObjectID hex strings); obtain them from POST /alert/list. Every ID must belong to the caller's account.
1Target incident ID (ObjectID hex string); obtain it from POST /incident/list.
^[0-9a-fA-F]{24}$Optional comment recorded on the merge feed entry. At most 1024 characters.
1024Optional new title for the target incident. At most 512 characters.
512Member ID of the new owner for the target incident; obtain it from POST /member/list.
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?