Resource Study.Roster.Role
Method PUT
Purpose Update permissions for an existing roleholder for a study
Client sends … RequestPUT role-URI
HeaderHost: host
HeaderDate: date
HeaderAuthorization: yosokumo user-identifier:request-digest
HeaderContent-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 … SuccessCode204 No Content
HeaderDate: date
Success (administrative privileges required by owner-roleholder not changed)Code200 OK
HeaderDate: date
HeaderContent-Type: content-type
Header (conditional)Content-Encoding: content-encoding
Header (conditional)Content-Length: content-length
HeaderContent-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 missingCode401 Unauthorized
HeaderWWW-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 recognizedCode404 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