Update api docs to better describe tokens

Fixes #87