also note to self: add this to Java and/or python API