Add use-cases and appropriate endpoints to README
Refine what happens if the manual slug is already taken