# Incident

Incident is a most important event type.<br>
Incident represents an event that:
- Started in the past,
- Have updates which can be added while incident is being handled,
- During creation and during its duration the total duration or end
  of the incident is not known,
- Is resolved when `resolved` Incident Update is created
  for this incident,
- Have non-0 duration. This means that Incident can't be created
  with `resolved` incident type.

Most typical use case:
- Hub Page list various customer-facing services,
- When one of the services has an outage, Incident is created manually
  or through automation,
- While team is working on restoring the service Incident Update entries
  are added manually or through automation to this incident to let
  customers know what's happening,
- Once issue is resolved, Incident Update with `monitoring` incident type
  is being created while team is keeping an eye on service health,
- Once situation is stable, Incident Update with `resolved` incident type
  is being created which ends the Incident.


## Create an Incident

 - [POST /hubs/{subdomain}/incidents](https://api-docs.statushub.com/api-v3-openapi/incident/createincident.md): Creates a new Incident. During creation, first Incident Update for this Incident will also be created.

## List Incidents

 - [GET /hubs/{subdomain}/incidents](https://api-docs.statushub.com/api-v3-openapi/incident/listincidents.md): Filters and returns Incident records for current Hub with basic info.

## Retrieve an Incident

 - [GET /hubs/{subdomain}/incidents/{incident_id}](https://api-docs.statushub.com/api-v3-openapi/incident/getincident.md): Returns data about single Incident.

## Delete an Incident

 - [DELETE /hubs/{subdomain}/incidents/{incident_id}](https://api-docs.statushub.com/api-v3-openapi/incident/deleteincident.md): Deletes Incident record. Records are soft-deleted which means that such deleted record can still be viewed or potentially restored.