Does idempotency include response codes?

http idempotent
Gili picture Gili · Jul 12, 2014 · Viewed 7.5k times · Source

Do repeated requests to idempotent methods have to return the same response code?

A lot of other people are asking the same question and ending up with contradicting answers. The answer should reference an authoritative source on the matter.

Answer

Gili picture Gili · Jul 12, 2014

I asked this question on the HTTP mailing list and was told that idempotency does not include return codes. Meaning, you are free to return HTTP 204 the first time a resource is deleted, and HTTP 404 at a later time, so long as the subsequent request does not change the server state.

While it is true that subsequent requests may not change the server state, the response codes are not considered part of that state.

Related questions

Consequences of POST not being idempotent (RESTful API)

I am wondering if my current approach makes sense or if there is a better way to do it. I have multiple situations where i want to create new objects and let the server assign an ID to those objects. …

Read More
REST API GET with sensitive data

I'm designing api with method that should be an idempotent, and should not modify any data on the server. It should be method that process request and return response for given parameters. One of the parameters is sensitive data. It's …

Read More
PUT vs. POST in REST

According to the HTTP/1.1 Spec: The POST method is used to request that the origin server accept the entity enclosed in the request as a new subordinate of the resource identified by the Request-URI in the Request-Line In other words, …

Read More