flesh out more of the API basics