# Event

Events - like actions - model _dynamic_ entities that couple various _static_ entities at a certain moment in
 time. Events are used for either real-time updates, or updates on earlier provided data. Notice that in both
 event types these are _updates_ on earlier provided data, whereas actions are usually used together with the
 entities they dynamically couple.

 There are various kinds of events that fall into the two earlier mentioned kinds.

 **Real-time updates**:
 - The **LocationUpdateEvent** that provides location data received from some GPS.
 - The **SensorUpdateEvent** that provides sensor value updates (such as temperature or speed measurements) received from a sensor.
 - The **StartMovingEvent**, **StopMovingEvent**, **StartEngineEvent**, **StopEngineEvent** that indicate events provided by Fleet Management Systems.

**Both real-time and projected/realized events**
- The **EmissionEvent** that contains information about how much emission has been produced during a move / on a trip / per consignment.
  Can be provided as an actual value, projected based on some calculation, or realized as measured by some sensor.
- The **FuelConsumedEvent** that contains information about how much fuel was consumed during a move / on a trip / per consignment.
  Can be provided as an actual value, projected based on some calculation, or realized as measured by some sensor.

**Updates on earlier provided data**:
 - The **UpdateEvent** that is used to update an earlier provided entity with new information. Note that only the changed data has to be provided.
 - The **AssociationCreatedEvent** and **AssociationRemovedEvent** that allow for _static_ entities to be coupled after the fact. Such as coupling a Vehicle to a Trip.

## Get a specific Event by its UUID

 - [GET /api/v5/events/{UUID}](https://otm-api-spec.redocly.app/api/5.7/otm/event/paths/~1api~1v5~1events~1%7Buuid%7D/get.md)

## Deletes a Event

 - [DELETE /api/v5/events/{UUID}](https://otm-api-spec.redocly.app/api/5.7/otm/event/paths/~1api~1v5~1events~1%7Buuid%7D/delete.md)

## Adds a new Event

 - [PUT /api/v5/events](https://otm-api-spec.redocly.app/api/5.7/otm/event/paths/~1api~1v5~1events/put.md)