curl --request POST \
--url 'https://api.flashcat.cloud/incident/work-item/assignees/reset?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"work_item_id": "wi_9fK2mNqRtVwXyZaBcDeFgH",
"version": 2,
"assignee_ids": [
3790925372131,
5068740052131
]
}
'import requests
url = "https://api.flashcat.cloud/incident/work-item/assignees/reset?app_key="
payload = {
"work_item_id": "wi_9fK2mNqRtVwXyZaBcDeFgH",
"version": 2,
"assignee_ids": [3790925372131, 5068740052131]
}
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({
work_item_id: 'wi_9fK2mNqRtVwXyZaBcDeFgH',
version: 2,
assignee_ids: [3790925372131, 5068740052131]
})
};
fetch('https://api.flashcat.cloud/incident/work-item/assignees/reset?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/incident/work-item/assignees/reset?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([
'work_item_id' => 'wi_9fK2mNqRtVwXyZaBcDeFgH',
'version' => 2,
'assignee_ids' => [
3790925372131,
5068740052131
]
]),
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/incident/work-item/assignees/reset?app_key="
payload := strings.NewReader("{\n \"work_item_id\": \"wi_9fK2mNqRtVwXyZaBcDeFgH\",\n \"version\": 2,\n \"assignee_ids\": [\n 3790925372131,\n 5068740052131\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/incident/work-item/assignees/reset?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"work_item_id\": \"wi_9fK2mNqRtVwXyZaBcDeFgH\",\n \"version\": 2,\n \"assignee_ids\": [\n 3790925372131,\n 5068740052131\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/incident/work-item/assignees/reset?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 \"work_item_id\": \"wi_9fK2mNqRtVwXyZaBcDeFgH\",\n \"version\": 2,\n \"assignee_ids\": [\n 3790925372131,\n 5068740052131\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01J8XQ3E5Z7JM2NTFQ5YJ8P9R4",
"data": {
"item": {
"work_item_id": "wi_68MHnkWBiyjrh6uhkxUyiZ",
"item_type": "follow_up",
"incident_id": "6a5f1e28807515413b384bce",
"post_mortem_id": "51d65cd9525c369379ba471b5512df63",
"title": "Follow-ups assigned to Bowen and Weili",
"status": "done",
"source_kind": "native",
"version": 2,
"assignee_ids": [
3790925372131,
4756301322131,
5068740052131
],
"created_by": 5329873302131,
"updated_by": 3790925372131,
"created_at_seconds": 1785495329,
"updated_at_seconds": 1785496384
},
"added_assignee_ids": [
5068740052131
],
"removed_assignee_ids": [
4756301322131
]
}
}{
"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."
}
}Reset work item assignees
Replace a work item’s entire assignee set.
curl --request POST \
--url 'https://api.flashcat.cloud/incident/work-item/assignees/reset?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"work_item_id": "wi_9fK2mNqRtVwXyZaBcDeFgH",
"version": 2,
"assignee_ids": [
3790925372131,
5068740052131
]
}
'import requests
url = "https://api.flashcat.cloud/incident/work-item/assignees/reset?app_key="
payload = {
"work_item_id": "wi_9fK2mNqRtVwXyZaBcDeFgH",
"version": 2,
"assignee_ids": [3790925372131, 5068740052131]
}
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({
work_item_id: 'wi_9fK2mNqRtVwXyZaBcDeFgH',
version: 2,
assignee_ids: [3790925372131, 5068740052131]
})
};
fetch('https://api.flashcat.cloud/incident/work-item/assignees/reset?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/incident/work-item/assignees/reset?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([
'work_item_id' => 'wi_9fK2mNqRtVwXyZaBcDeFgH',
'version' => 2,
'assignee_ids' => [
3790925372131,
5068740052131
]
]),
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/incident/work-item/assignees/reset?app_key="
payload := strings.NewReader("{\n \"work_item_id\": \"wi_9fK2mNqRtVwXyZaBcDeFgH\",\n \"version\": 2,\n \"assignee_ids\": [\n 3790925372131,\n 5068740052131\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/incident/work-item/assignees/reset?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"work_item_id\": \"wi_9fK2mNqRtVwXyZaBcDeFgH\",\n \"version\": 2,\n \"assignee_ids\": [\n 3790925372131,\n 5068740052131\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/incident/work-item/assignees/reset?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 \"work_item_id\": \"wi_9fK2mNqRtVwXyZaBcDeFgH\",\n \"version\": 2,\n \"assignee_ids\": [\n 3790925372131,\n 5068740052131\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01J8XQ3E5Z7JM2NTFQ5YJ8P9R4",
"data": {
"item": {
"work_item_id": "wi_68MHnkWBiyjrh6uhkxUyiZ",
"item_type": "follow_up",
"incident_id": "6a5f1e28807515413b384bce",
"post_mortem_id": "51d65cd9525c369379ba471b5512df63",
"title": "Follow-ups assigned to Bowen and Weili",
"status": "done",
"source_kind": "native",
"version": 2,
"assignee_ids": [
3790925372131,
4756301322131,
5068740052131
],
"created_by": 5329873302131,
"updated_by": 3790925372131,
"created_at_seconds": 1785495329,
"updated_at_seconds": 1785496384
},
"added_assignee_ids": [
5068740052131
],
"removed_assignee_ids": [
4756301322131
]
}
}{
"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."
}
}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
Full replacement of a work item's assignee set.
Work item ID (opaque string, max 128 characters).
128Current item version for optimistic locking. Must match the stored version.
Legacy alias for the replacement assignee set. Equivalent to assignees with every entry type person. Mutually exclusive with assignees: sending both returns an error. An empty array clears all assignees.
Replacement assignee set. Each entry is {type, id?}. type is person or ai_sre; an ai_sre entry omits id. Mutually exclusive with assignee_ids: sending both returns an error. assignee_ids is the legacy alias and is equivalent to an all-person list. At most 20 entries. An empty array clears all assignees.
20Show 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?