DELETE

Requests that the target resource be deleted.

Use DELETE when the target resource defines deletion semantics. DELETE is idempotent, but repeating it can still return a different status such as 404.

httpmethodsidempotency

Reference (http)

DELETE /api/users/42 HTTP/1.1
Host: api.example.com

Use DELETE when the target resource defines deletion semantics. DELETE is idempotent, but repeating it can still return a different status such as 404.

Common mistakes

Assuming idempotent means every repeated response must be identical.

Registry reference: rfc9110

Sources

MDN HTTP Reference