Create a work item

curl --request POST \
  --url 'https://api.flashcat.cloud/incident/work-item/create?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "item_type": "action",
  "title": "Roll back the v2.14 deployment on web-server-01",
  "description": "CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.",
  "status": "open",
  "priority": "high",
  "incident_id": "6a5f1e28807515413b384bce",
  "assignee_ids": [
    3790925372131
  ],
  "idempotency_key": "create-wi-20260731-0001"
}
'

import requests

url = "https://api.flashcat.cloud/incident/work-item/create?app_key="

payload = {
    "item_type": "action",
    "title": "Roll back the v2.14 deployment on web-server-01",
    "description": "CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.",
    "status": "open",
    "priority": "high",
    "incident_id": "6a5f1e28807515413b384bce",
    "assignee_ids": [3790925372131],
    "idempotency_key": "create-wi-20260731-0001"
}
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({
    item_type: 'action',
    title: 'Roll back the v2.14 deployment on web-server-01',
    description: 'CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.',
    status: 'open',
    priority: 'high',
    incident_id: '6a5f1e28807515413b384bce',
    assignee_ids: [3790925372131],
    idempotency_key: 'create-wi-20260731-0001'
  })
};

fetch('https://api.flashcat.cloud/incident/work-item/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/incident/work-item/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([
    'item_type' => 'action',
    'title' => 'Roll back the v2.14 deployment on web-server-01',
    'description' => 'CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.',
    'status' => 'open',
    'priority' => 'high',
    'incident_id' => '6a5f1e28807515413b384bce',
    'assignee_ids' => [
        3790925372131
    ],
    'idempotency_key' => 'create-wi-20260731-0001'
  ]),
  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/create?app_key="

	payload := strings.NewReader("{\n  \"item_type\": \"action\",\n  \"title\": \"Roll back the v2.14 deployment on web-server-01\",\n  \"description\": \"CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.\",\n  \"status\": \"open\",\n  \"priority\": \"high\",\n  \"incident_id\": \"6a5f1e28807515413b384bce\",\n  \"assignee_ids\": [\n    3790925372131\n  ],\n  \"idempotency_key\": \"create-wi-20260731-0001\"\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/create?app_key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"item_type\": \"action\",\n  \"title\": \"Roll back the v2.14 deployment on web-server-01\",\n  \"description\": \"CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.\",\n  \"status\": \"open\",\n  \"priority\": \"high\",\n  \"incident_id\": \"6a5f1e28807515413b384bce\",\n  \"assignee_ids\": [\n    3790925372131\n  ],\n  \"idempotency_key\": \"create-wi-20260731-0001\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flashcat.cloud/incident/work-item/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  \"item_type\": \"action\",\n  \"title\": \"Roll back the v2.14 deployment on web-server-01\",\n  \"description\": \"CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.\",\n  \"status\": \"open\",\n  \"priority\": \"high\",\n  \"incident_id\": \"6a5f1e28807515413b384bce\",\n  \"assignee_ids\": [\n    3790925372131\n  ],\n  \"idempotency_key\": \"create-wi-20260731-0001\"\n}"

response = http.request(request)
puts response.read_body

{
  "request_id": "01J8XQ3E5Z7JM2NTFQ5YJ8P9R4",
  "data": {
    "item": {
      "work_item_id": "wi_9fK2mNqRtVwXyZaBcDeFgH",
      "item_type": "action",
      "incident_id": "6a5f1e28807515413b384bce",
      "title": "Roll back the v2.14 deployment on web-server-01",
      "status": "open",
      "source_kind": "native",
      "version": 1,
      "assignee_ids": [
        3790925372131
      ],
      "created_by": 3790925372131,
      "updated_by": 3790925372131,
      "created_at_seconds": 1785496400,
      "updated_at_seconds": 1785496400
    },
    "added_assignee_ids": [
      3790925372131
    ]
  }
}

{
  "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."
  }
}

POST

incident

work-item

create

Create a work item

curl --request POST \
  --url 'https://api.flashcat.cloud/incident/work-item/create?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "item_type": "action",
  "title": "Roll back the v2.14 deployment on web-server-01",
  "description": "CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.",
  "status": "open",
  "priority": "high",
  "incident_id": "6a5f1e28807515413b384bce",
  "assignee_ids": [
    3790925372131
  ],
  "idempotency_key": "create-wi-20260731-0001"
}
'

import requests

url = "https://api.flashcat.cloud/incident/work-item/create?app_key="

payload = {
    "item_type": "action",
    "title": "Roll back the v2.14 deployment on web-server-01",
    "description": "CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.",
    "status": "open",
    "priority": "high",
    "incident_id": "6a5f1e28807515413b384bce",
    "assignee_ids": [3790925372131],
    "idempotency_key": "create-wi-20260731-0001"
}
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({
    item_type: 'action',
    title: 'Roll back the v2.14 deployment on web-server-01',
    description: 'CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.',
    status: 'open',
    priority: 'high',
    incident_id: '6a5f1e28807515413b384bce',
    assignee_ids: [3790925372131],
    idempotency_key: 'create-wi-20260731-0001'
  })
};

fetch('https://api.flashcat.cloud/incident/work-item/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/incident/work-item/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([
    'item_type' => 'action',
    'title' => 'Roll back the v2.14 deployment on web-server-01',
    'description' => 'CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.',
    'status' => 'open',
    'priority' => 'high',
    'incident_id' => '6a5f1e28807515413b384bce',
    'assignee_ids' => [
        3790925372131
    ],
    'idempotency_key' => 'create-wi-20260731-0001'
  ]),
  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/create?app_key="

	payload := strings.NewReader("{\n  \"item_type\": \"action\",\n  \"title\": \"Roll back the v2.14 deployment on web-server-01\",\n  \"description\": \"CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.\",\n  \"status\": \"open\",\n  \"priority\": \"high\",\n  \"incident_id\": \"6a5f1e28807515413b384bce\",\n  \"assignee_ids\": [\n    3790925372131\n  ],\n  \"idempotency_key\": \"create-wi-20260731-0001\"\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/create?app_key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"item_type\": \"action\",\n  \"title\": \"Roll back the v2.14 deployment on web-server-01\",\n  \"description\": \"CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.\",\n  \"status\": \"open\",\n  \"priority\": \"high\",\n  \"incident_id\": \"6a5f1e28807515413b384bce\",\n  \"assignee_ids\": [\n    3790925372131\n  ],\n  \"idempotency_key\": \"create-wi-20260731-0001\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flashcat.cloud/incident/work-item/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  \"item_type\": \"action\",\n  \"title\": \"Roll back the v2.14 deployment on web-server-01\",\n  \"description\": \"CPU saturation started right after the v2.14 rollout; roll back and watch the error rate.\",\n  \"status\": \"open\",\n  \"priority\": \"high\",\n  \"incident_id\": \"6a5f1e28807515413b384bce\",\n  \"assignee_ids\": [\n    3790925372131\n  ],\n  \"idempotency_key\": \"create-wi-20260731-0001\"\n}"

response = http.request(request)
puts response.read_body

{
  "request_id": "01J8XQ3E5Z7JM2NTFQ5YJ8P9R4",
  "data": {
    "item": {
      "work_item_id": "wi_9fK2mNqRtVwXyZaBcDeFgH",
      "item_type": "action",
      "incident_id": "6a5f1e28807515413b384bce",
      "title": "Roll back the v2.14 deployment on web-server-01",
      "status": "open",
      "source_kind": "native",
      "version": 1,
      "assignee_ids": [
        3790925372131
      ],
      "created_by": 3790925372131,
      "updated_by": 3790925372131,
      "created_at_seconds": 1785496400,
      "updated_at_seconds": 1785496400
    },
    "added_assignee_ids": [
      3790925372131
    ]
  }
}

{
  "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	Incidents Manage (`on-call`)

Usage

Requires the On-call Pro license.
An action anchors to an active incident and must NOT set post_mortem_id; a follow_up REQUIRES the post_mortem_id of a post-mortem linked to incident_id.
Assignees must be active members who can already read the anchor incident or post-mortem — assignment never grants access.
Newly added assignees are notified.
Retrying with the same (creator, idempotency_key) replays the original item with idempotent_replay: true instead of creating a duplicate.
Audited — changes are recorded in the audit log.

Authorizations

app_key

string

query

required

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

Parameters for creating an incident work item.

item_type

enum<string>

required

action anchors to an active incident and must not set post_mortem_id; follow_up requires post_mortem_id.

Available options:

action,

follow_up

title

string

required

Item title (max 512 characters).

Maximum string length: 512

incident_id

string

required

Incident ID (MongoDB ObjectID) the item is anchored to.

Pattern: ^[0-9a-fA-F]{24}$

idempotency_key

string

required

Client-generated idempotency key (max 128 characters; letters, digits, _, -, ., : only).

Maximum string length: 128

Pattern: ^[A-Za-z0-9_\-.:]+$

description

string

Optional longer description (max 65,535 characters).

Maximum string length: 65535

status

string

Optional client-defined initial status (max 64 characters).

Maximum string length: 64

priority

string

Optional client-defined priority (max 64 characters).

Maximum string length: 64

post_mortem_id

string

Post-mortem ID (32-character hex string). Required for follow_up, forbidden for action. The post-mortem must be linked to incident_id.

assignee_ids

integer<int64>[]

Initial assignee member IDs. Assignees must be active members who can already read the anchor; assignment never grants access.

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.

request_id

string

required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data

object

required

Result of creating a work item.

Show child attributes

Developer Guide

On-call

Monitors

RUM

AI SRE

Platform

Create a work item

Restrictions

Usage

Authorizations

Body

Response

​Restrictions

​Usage

Authorizations

Body

Response

Restrictions

Usage