add API documentation note about checking existing hashes