I'm curious about https://api.stackexchange.com/docs . I looked up and studied the naming convention to make a REST api. I've seen that in the naming convention, don't use verbs and in the case of the http method, don't put them in the URI.
However, if you look at the code below, you can see that the delete of the http method is in the URI. Is there a reason why they did this?
comments/{id}/delete
Also, if you look at the code below, is there a reason why the verb add was used at the end?
/posts/{id}/comments/add
As far as I'm concerned, since the http method POST is used, I think it's better to delete the add or use it as an addition.
Additional questions, is there a reason why POST is used as the http method instead of deleting it on the answers/{id}/upvote/undo.
I'm not sure if it's right to leave this question here, but I'm leaving a question. You might think it's a silly question, but I'd really appreciate it if you could answer it.