Review complete Trace-FOSS - OpenAPI Documentation

**As** API User
**I want** to have a valid API documentation
**so that** I can trust in the documentation an develop against it.
 
## Hints / Details
- have a deep look on the API documentation

##  Acceptance Criteria
- Documentation has been updated to the current state of the api
- It has reasonable examples
 
## Out of Scope
- ...