curl --request POST \
--url 'https://api.flashcat.cloud/status-page/change/timeline/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"page_id": 5750613685214,
"change_id": 5821693893131,
"status": "identified",
"description": "We have identified the root cause and are working on a fix.",
"at_seconds": 1712003600,
"component_changes": [
{
"component_id": "01KC3GAZ6ZJE40H55GM31RPWZE",
"status": "partial_outage"
}
]
}
'import requests
url = "https://api.flashcat.cloud/status-page/change/timeline/create?app_key="
payload = {
"page_id": 5750613685214,
"change_id": 5821693893131,
"status": "identified",
"description": "We have identified the root cause and are working on a fix.",
"at_seconds": 1712003600,
"component_changes": [
{
"component_id": "01KC3GAZ6ZJE40H55GM31RPWZE",
"status": "partial_outage"
}
]
}
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({
page_id: 5750613685214,
change_id: 5821693893131,
status: 'identified',
description: 'We have identified the root cause and are working on a fix.',
at_seconds: 1712003600,
component_changes: [{component_id: '01KC3GAZ6ZJE40H55GM31RPWZE', status: 'partial_outage'}]
})
};
fetch('https://api.flashcat.cloud/status-page/change/timeline/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/status-page/change/timeline/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([
'page_id' => 5750613685214,
'change_id' => 5821693893131,
'status' => 'identified',
'description' => 'We have identified the root cause and are working on a fix.',
'at_seconds' => 1712003600,
'component_changes' => [
[
'component_id' => '01KC3GAZ6ZJE40H55GM31RPWZE',
'status' => 'partial_outage'
]
]
]),
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/status-page/change/timeline/create?app_key="
payload := strings.NewReader("{\n \"page_id\": 5750613685214,\n \"change_id\": 5821693893131,\n \"status\": \"identified\",\n \"description\": \"We have identified the root cause and are working on a fix.\",\n \"at_seconds\": 1712003600,\n \"component_changes\": [\n {\n \"component_id\": \"01KC3GAZ6ZJE40H55GM31RPWZE\",\n \"status\": \"partial_outage\"\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/status-page/change/timeline/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"page_id\": 5750613685214,\n \"change_id\": 5821693893131,\n \"status\": \"identified\",\n \"description\": \"We have identified the root cause and are working on a fix.\",\n \"at_seconds\": 1712003600,\n \"component_changes\": [\n {\n \"component_id\": \"01KC3GAZ6ZJE40H55GM31RPWZE\",\n \"status\": \"partial_outage\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/status-page/change/timeline/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 \"page_id\": 5750613685214,\n \"change_id\": 5821693893131,\n \"status\": \"identified\",\n \"description\": \"We have identified the root cause and are working on a fix.\",\n \"at_seconds\": 1712003600,\n \"component_changes\": [\n {\n \"component_id\": \"01KC3GAZ6ZJE40H55GM31RPWZE\",\n \"status\": \"partial_outage\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"update_id": "01KP0311872NVYFRRQ82FWXAP4"
}
}{
"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 event timeline entry
Add a timeline update to a status page event.
curl --request POST \
--url 'https://api.flashcat.cloud/status-page/change/timeline/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"page_id": 5750613685214,
"change_id": 5821693893131,
"status": "identified",
"description": "We have identified the root cause and are working on a fix.",
"at_seconds": 1712003600,
"component_changes": [
{
"component_id": "01KC3GAZ6ZJE40H55GM31RPWZE",
"status": "partial_outage"
}
]
}
'import requests
url = "https://api.flashcat.cloud/status-page/change/timeline/create?app_key="
payload = {
"page_id": 5750613685214,
"change_id": 5821693893131,
"status": "identified",
"description": "We have identified the root cause and are working on a fix.",
"at_seconds": 1712003600,
"component_changes": [
{
"component_id": "01KC3GAZ6ZJE40H55GM31RPWZE",
"status": "partial_outage"
}
]
}
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({
page_id: 5750613685214,
change_id: 5821693893131,
status: 'identified',
description: 'We have identified the root cause and are working on a fix.',
at_seconds: 1712003600,
component_changes: [{component_id: '01KC3GAZ6ZJE40H55GM31RPWZE', status: 'partial_outage'}]
})
};
fetch('https://api.flashcat.cloud/status-page/change/timeline/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/status-page/change/timeline/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([
'page_id' => 5750613685214,
'change_id' => 5821693893131,
'status' => 'identified',
'description' => 'We have identified the root cause and are working on a fix.',
'at_seconds' => 1712003600,
'component_changes' => [
[
'component_id' => '01KC3GAZ6ZJE40H55GM31RPWZE',
'status' => 'partial_outage'
]
]
]),
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/status-page/change/timeline/create?app_key="
payload := strings.NewReader("{\n \"page_id\": 5750613685214,\n \"change_id\": 5821693893131,\n \"status\": \"identified\",\n \"description\": \"We have identified the root cause and are working on a fix.\",\n \"at_seconds\": 1712003600,\n \"component_changes\": [\n {\n \"component_id\": \"01KC3GAZ6ZJE40H55GM31RPWZE\",\n \"status\": \"partial_outage\"\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/status-page/change/timeline/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"page_id\": 5750613685214,\n \"change_id\": 5821693893131,\n \"status\": \"identified\",\n \"description\": \"We have identified the root cause and are working on a fix.\",\n \"at_seconds\": 1712003600,\n \"component_changes\": [\n {\n \"component_id\": \"01KC3GAZ6ZJE40H55GM31RPWZE\",\n \"status\": \"partial_outage\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/status-page/change/timeline/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 \"page_id\": 5750613685214,\n \"change_id\": 5821693893131,\n \"status\": \"identified\",\n \"description\": \"We have identified the root cause and are working on a fix.\",\n \"at_seconds\": 1712003600,\n \"component_changes\": [\n {\n \"component_id\": \"01KC3GAZ6ZJE40H55GM31RPWZE\",\n \"status\": \"partial_outage\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"update_id": "01KP0311872NVYFRRQ82FWXAP4"
}
}{
"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 | Status Pages Events Manage (on-call) |
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
Parameters for appending an update to a status page event timeline.
Status page ID.
Target event ID.
New event status. Must match the event type. When the status transitions to resolved or completed, all referenced components must become operational.
investigating, identified, monitoring, resolved, scheduled, ongoing, completed Update timestamp in unix seconds. Defaults to now when omitted.
Update description (Markdown). Required.
Component status transitions applied by this update. Component IDs must be unique.
Show child attributes
Show child attributes
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?