language API for hierarchy actions