the start of the documented api