specify HTTP headers in spec
POST/PATCH/PUT params should be in body
clarify filterable resource names