Examples Swagger API needs clarification

Within Swagger API the usage examples are'nt clear enough. E.g. the following example JSON Request results in an error. { "credential": "Ut ea eveniet dolor minima nemo modi.", "key": "key1", "namespace": "transit" } Expected behaviour is that examples are resulting in valid response.