add future API to implement in documentation