Skip to main content
POST
/
incidents
Creates a new incident.
curl --request POST \
  --url https://api.example.com/incidents \
  --header 'Content-Type: application/json' \
  --data '
{
  "incident_type": "<string>",
  "severity": "<string>",
  "description": "<string>",
  "location": {
    "latitude": 123,
    "longitude": 123,
    "altitude": 123
  }
}
'
{
  "blockchain_records": [
    "<string>"
  ],
  "created_at": "<string>",
  "evidence_count": 1,
  "id": "<string>",
  "incident_type": "<string>",
  "severity": "<string>",
  "status": "<string>",
  "location": {
    "latitude": 123,
    "longitude": 123,
    "altitude": 123
  }
}

Body

application/json

Request to create a new incident.

​
incident_type
string
required

Type classification of the incident.

​
severity
string
required

Severity level of the incident.

​
description
string | null

Optional human-readable description.

​
location
null | object

Geographic location where the incident occurred.

Response

201 - application/json

Incident created

Response for a single incident.

​
blockchain_records
string[]
required

Blockchain transaction hashes anchoring this incident.

​
created_at
string
required

RFC 3339 creation timestamp.

​
evidence_count
integer<int32>
required

Number of evidence items associated with this incident.

Required range: x >= 0
​
id
string
required

Unique incident identifier.

​
incident_type
string
required

Type classification (e.g. "fire", "flood").

​
severity
string
required

Severity level (e.g. "low", "high", "critical").

​
status
string
required

Lifecycle status (e.g. "open", "resolved").

​
location
null | object

Geographic location where the incident occurred.