| Resource |
Study.Roster.Role |
| Method |
PUT |
| Purpose |
Update permissions for an existing roleholder for a study |
| Client sends … |
Request | PUT role-URI |
| Header | Host: host |
| Header | Date: date |
| Header | Authorization: yosokumo user-identifier:request-digest |
| Header | Content-Type: content-type |
| Header (optional) | Content-Encoding: content-encoding |
| Header (optional) | Content-Length: content-length |
| Header (optional) | Content-MD5: content-digest |
| Header (optional) | Accept: content-type(s) |
| Entity | <role document> |
| Server returns … |
Success | Code | 204 No Content |
| Header | Date: date |
| Success (administrative privileges required by owner-roleholder not changed) | Code | 200 OK |
| Header | Date: date |
| Header | Content-Type: content-type |
| Header (conditional) | Content-Encoding: content-encoding |
| Header (conditional) | Content-Length: content-length |
| Header | Content-MD5: content-digest |
| Entity | <message document> |
| • Authorization header malformed |
| • Put document not well-formed |
| • Put document length does not match Content-Length header value |
| • Put document digest does not match Content-MD5 header value |
| • Put document not a role |
|
Code |
400 Bad Request |
| Authorization header missing | Code | 401 Unauthorized |
| Header | WWW-Authenticate: yosokumo user:digest |
| • Requesting user not recognized |
| • Request digest incorrect |
| • Requesting user lacks PUT role permission for this study |
|
Code |
403 Forbidden |
| Requested URI not recognized | Code | 404 Not Found |
| • User referenced in role document conflicts with role-URI |
| • Study referenced in role document conflicts with role-URI |
|
Code |
409 Conflict |
| • Data interchange format of posted document not recognized |
| • Encoding of posted document not recognized |
|
Code |
415 Unsupported Format |