draft document for a new API