List my schedules
curl --request POST \
--url 'https://api.flashcat.cloud/schedule/self?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"start": 1712000000,
"end": 1712086400
}
'import requests
url = "https://api.flashcat.cloud/schedule/self?app_key="
payload = {
"start": 1712000000,
"end": 1712086400
}
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({start: 1712000000, end: 1712086400})
};
fetch('https://api.flashcat.cloud/schedule/self?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/schedule/self?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([
'start' => 1712000000,
'end' => 1712086400
]),
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/schedule/self?app_key="
payload := strings.NewReader("{\n \"start\": 1712000000,\n \"end\": 1712086400\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/schedule/self?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"start\": 1712000000,\n \"end\": 1712086400\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/schedule/self?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 \"start\": 1712000000,\n \"end\": 1712086400\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"items": [
{
"id": 2539108069860,
"name": "Open Source Q&A",
"account_id": 2451002751131,
"group_id": 2477033058131,
"disabled": 0,
"create_at": 1702623874,
"create_by": 2451002751131,
"update_at": 1710468081,
"update_by": 2476444212131,
"layers": [
{
"account_id": 2451002751131,
"name": "Rule 1",
"schedule_id": 2539108069860,
"hidden": 0,
"mode": 0,
"weight": 0,
"groups": [
{
"group_name": "A",
"name": "A",
"members": [
{
"role_id": 0,
"person_ids": [
2476444212131
]
}
],
"start": 0,
"end": 0
},
{
"group_name": "B",
"name": "B",
"members": [
{
"role_id": 0,
"person_ids": [
2469167612131
]
}
],
"start": 0,
"end": 0
}
],
"rotation_duration": 86400,
"handoff_time": 0,
"enable_time": 1702623874,
"expire_time": 0,
"restrict_mode": 0,
"restrict_start": 0,
"restrict_end": 0,
"restrict_periods": [],
"day_mask": {
"repeat": [
1,
2,
3,
4,
5
]
},
"create_at": 1702623874,
"create_by": 2451002751131,
"update_at": 1710468081,
"update_by": 2476444212131,
"layer_name": "Rule 1",
"fair_rotation": false,
"layer_start": 1702623874,
"layer_end": null,
"rotation_unit": "day",
"rotation_value": 1,
"mask_continuous_enabled": false
}
],
"schedule_layers": null,
"final_schedule": {
"layer_name": "",
"name": "",
"mode": 0,
"schedules": null
},
"notify": {
"fixed_time": null,
"by": null,
"webhooks": null
},
"schedule_id": 2539108069860,
"schedule_name": "Open Source Q&A",
"team_id": 2477033058131,
"description": "",
"layer_schedules": null,
"status": 0,
"cur_oncall": null,
"next_oncall": null
}
]
}
}{
"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."
}
}Schedules
List my schedules
Return on-call schedules where the current user is assigned.
POST
/
schedule
/
self
List my schedules
curl --request POST \
--url 'https://api.flashcat.cloud/schedule/self?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"start": 1712000000,
"end": 1712086400
}
'import requests
url = "https://api.flashcat.cloud/schedule/self?app_key="
payload = {
"start": 1712000000,
"end": 1712086400
}
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({start: 1712000000, end: 1712086400})
};
fetch('https://api.flashcat.cloud/schedule/self?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/schedule/self?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([
'start' => 1712000000,
'end' => 1712086400
]),
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/schedule/self?app_key="
payload := strings.NewReader("{\n \"start\": 1712000000,\n \"end\": 1712086400\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/schedule/self?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"start\": 1712000000,\n \"end\": 1712086400\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/schedule/self?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 \"start\": 1712000000,\n \"end\": 1712086400\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"items": [
{
"id": 2539108069860,
"name": "Open Source Q&A",
"account_id": 2451002751131,
"group_id": 2477033058131,
"disabled": 0,
"create_at": 1702623874,
"create_by": 2451002751131,
"update_at": 1710468081,
"update_by": 2476444212131,
"layers": [
{
"account_id": 2451002751131,
"name": "Rule 1",
"schedule_id": 2539108069860,
"hidden": 0,
"mode": 0,
"weight": 0,
"groups": [
{
"group_name": "A",
"name": "A",
"members": [
{
"role_id": 0,
"person_ids": [
2476444212131
]
}
],
"start": 0,
"end": 0
},
{
"group_name": "B",
"name": "B",
"members": [
{
"role_id": 0,
"person_ids": [
2469167612131
]
}
],
"start": 0,
"end": 0
}
],
"rotation_duration": 86400,
"handoff_time": 0,
"enable_time": 1702623874,
"expire_time": 0,
"restrict_mode": 0,
"restrict_start": 0,
"restrict_end": 0,
"restrict_periods": [],
"day_mask": {
"repeat": [
1,
2,
3,
4,
5
]
},
"create_at": 1702623874,
"create_by": 2451002751131,
"update_at": 1710468081,
"update_by": 2476444212131,
"layer_name": "Rule 1",
"fair_rotation": false,
"layer_start": 1702623874,
"layer_end": null,
"rotation_unit": "day",
"rotation_value": 1,
"mask_continuous_enabled": false
}
],
"schedule_layers": null,
"final_schedule": {
"layer_name": "",
"name": "",
"mode": 0,
"schedules": null
},
"notify": {
"fixed_time": null,
"by": null,
"webhooks": null
},
"schedule_id": 2539108069860,
"schedule_name": "Open Source Q&A",
"team_id": 2477033058131,
"description": "",
"layer_schedules": null,
"status": 0,
"cur_oncall": null,
"next_oncall": null
}
]
}
}{
"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 | Schedules Read (on-call) or Schedules 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
application/json
Query parameters for listing the current user's schedules. Both start and end are Unix timestamps (seconds). If omitted they default to 0. The window must not exceed 30 days.
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?
⌘I