api post interface; closes #1