updated apidoc to the current possibilities