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
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
object

Geographic location where the incident occurred.