title: Restful API naming conventions
body: <p>So me and my boss aren't agreeing here and can't find any information on it. Scenario: I want to get all the users for a certain organisation. What should the URL be?</p>
  
  <p><code>mydomain.com/users/by/organisation/{orgId}</code></p>
  
  <p>OR</p>
  
  <p><code>mydomain.com/organisation/{orgId}/users</code></p>
  
  <p>Our arguments: </p>
  
  <p>Case 1: The call is expected to return "users" and therefore the "resource" (first part of the call) should relate to it. </p>
  
  <p>Case 2: The organisation "owns"/"is the parent of" the user and therefore the organisation should be first.</p>
  
  <p>What are your thoughts?</p>
  
  <p><strong>UPDATE:</strong>
  I am not to worried about what comes after the <code>mydomain.com/{resource}</code>. The question relates mostly to whether the HTTP action (GET, POST, PUT, DELETE) should relate to the first resource <code>mydomain.com/users</code> or whether it should reflect the relationship <code>mydomain.com/organisations/users/</code>.</p>