@thomassittig @ThisIsFlorianK IMO
Swagger/OpenAPI syntax is not suited well to document relationships between
endpoint which make up workflows. You have to know the order of calls by reading
a second documentation.