new api commands, as discussed.