specify return code for failed 'waiting' -> 'active' request
rename metadata to user_data in spec
specify parameter names more precisely in spec
specify HTTP headers in spec
POST/PATCH/PUT params should be in body
clarify filterable resource names
Merge pull request #7 from mark-burnett/clarify-spec

Clarify spec