title: Create request with POST, which response codes 200 or 201 and content
body: <p>Suppose I write a REST service whose intent is to add a new data item to a system.</p>
  
  <p>I plan to POST to </p>
  
  <pre><code>http://myhost/serviceX/someResources
  </code></pre>
  
  <p>Suppose that works, what response code should I use? And what content might I return.</p>
  
  <p>I'm looking at the <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html" rel="noreferrer">definitions</a> of HTTP response codes and see these possibilities:</p>
  
  <p>200: Return <em>an entity describing or containing the result of the action;</em></p>
  
  <p>201: which means CREATED. Meaning *The request has been fulfilled and resulted in a new resource being created. The newly created resource can be referenced by the URI(s) returned in the entity of the response, with the most specific URI for the resource given by a Location header field. The response SHOULD include an entity containing a list of resource characteristics and location(s) from which the user or user agent can choose the one most appropriate. The entity format is specified by the media type given in the Content-Type header field. *</p>
  
  <p>The latter sounds more in line with the Http spec, but I'm not at all clear what </p>
  
  <blockquote>
    <p>The response SHOULD include an entity
    containing a list of resource
    characteristics and location(s)</p>
  </blockquote>
  
  <p>means.</p>
  
  <p>Recommendations? Interpretations?</p>