Create a new incident

POST

/v1/incidents

const url = 'https://api.adversarial.com/api/v1/incidents';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"assigned_to":null,"contained_date":null,"description":"","detected_date":null,"occurred_date":null,"responded_date":null,"severity":null,"severity_reasoning":null,"source":null,"status":null,"title":""}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.adversarial.com/api/v1/incidents \
  --header 'Content-Type: application/json' \
  --data '{ "assigned_to": null, "contained_date": null, "description": "", "detected_date": null, "occurred_date": null, "responded_date": null, "severity": null, "severity_reasoning": null, "source": null, "status": null, "title": "" }'

Request Body

application/json

One of:

null
object

null

Responses

201

Incident created

application/json

Relationship, core incident information

object

assigned_to

One of:

null
object

null

A User as returned by the API.

Profile images are not embedded — clients fetch them from GET /api/v1/{icon} when icon is Some.

object

email

required

string

first_name

required

string

icon

Relative path to the user’s avatar endpoint, e.g. "users/{id}/avatar?v={hash}". None when the user has no avatar.

string | null

required

string format: uuid

last_name

required

string

contained_date

string | null format: date-time

created_date

required

string format: date-time

description

required

string

detected_date

required

string format: date-time

required

string

occurred_date

string | null format: date-time

opened_by

required

A User as returned by the API.

Profile images are not embedded — clients fetch them from GET /api/v1/{icon} when icon is Some.

object

email

required

string

first_name

required

string

icon

Relative path to the user’s avatar endpoint, e.g. "users/{id}/avatar?v={hash}". None when the user has no avatar.

string | null

required

string format: uuid

last_name

required

string

parent_id

When set, this incident is linked under the named parent incident.

string | null

responded_date

string | null format: date-time

severity

One of:

null
string

null

severity_reasoning

string | null

source

required

Where the incident was reported from (e.g. “Employee Reported”). Always present.

string

status

required

The status of an incident

string

Allowed values: New In Progress Review Closed

title

required

string

updated_by

required

A User as returned by the API.

Profile images are not embedded — clients fetch them from GET /api/v1/{icon} when icon is Some.

object

email

required

string

first_name

required

string

icon

Relative path to the user’s avatar endpoint, e.g. "users/{id}/avatar?v={hash}". None when the user has no avatar.

string | null

required

string format: uuid

last_name

required

string

updated_date

required

string format: date-time

Example

{
  "id": "INC-00001",
  "parent_id": "INC-00001",
  "severity": "SEV-5",
  "status": "New"
}

400

Validation failed (e.g. unknown source, inactive assignee)