add more examples to api documentation

[coredirigent]

It would be nice if there were more examples in api documentation, eg for post and put requests. furthermore Mandatory fields should be marked. Thank you for your efforts