# Action

Actions are _dynamic_ entities that are able to couple together various _static_ entities at a certain moment in
 time. For instance a Load action couples together a Consignment and a Vehicle at the moment the Loading happens.

 There are various types of Actions:
 - The **Stop** that models visiting a certain location at a certain time and potentially doing several other actions at that location.
 - The **Load** action, that models loading in one or multiple Consignments into a vehicle or some sort of container.
 - The **Unload** action, that models unloading one or multiple Consignments from a vehicle or some other sort of container.
 - The **HandOver** that indicates transferring a consignment from one Actor to another.
 - The **Move** that models moving between two or more locations, potentially with detailed route information on _how_ to move between these locations.
 - The **AttachTransportEquipment** that allows you to attach some equipment to the associated vehicle. Note that you can both
   load/unload and attach/detach TransportEquipments. For instance loading a container on a ship, or attach a trailer to a truck. So choose the one that is most appropriate.
 - The **DetachTransportEquipment** that allows you to detach some previously attached equipment from the associated vehicle.
 - The **Break** action that models a mandatory resting period for the driver of the vehicle. During this period
   the driver is prohibited from doing any driving activities or other work.
 - The **Wait** action that models waiting at a particular location during the trip. This can be due to various
   circumstances such as waiting for the vehicle to be transported by a ferry or train. Or because of waiting at
   frontiers or docks (e.g. the dock of the loading/unload location is occupied) or traffic prohibitions. The
   driver is allowed to leave the vehicle during this period. An important aspect distinguishing this from the
   _break_ action is that waiting times can be shortened because of changing circumstances. For example, if the
   original waiting time was expected to be 15 minutes because of an occupied dock, but the driver is 10 minutes
   late, the waiting time can be shortened to 5 minutes until the dock is free.
 - The **GenericAction** for whenever any of the above actions cannot model the situation appropriately.

## Get a specific Action by its UUID

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

## Deletes a Action

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

## Adds a new Action

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