add phpdoc, to complete
work on custom api role