There is some very high level documentation for the oemanager rest API: 

However this misses some important things like: 

- What are the possible values for fields with enum-like values and the meaning of those , like SessionState Auxilliary and stuff like that. 

- What is the meaning of every field, like SessionExternalState (I managed to find that one on a different page in a different context, it's what ) 

Is it possible to document each end point to explain what the info it returns means and what the meaning of each fields is and what the possible values are for enum-like fields.