documentation update

hi yeehaa, please find the api design in the pull request
i think we decided that here it would be a `PUT /api/v1/users/:userId/paths/:pathId/places/:placesId` to maintain REST convention. the update would be a flag on the places object that belongs to a user through a path.