Document REST API better