UpdateQualificationScore

The UpdateQualificationScore operation changes the value of a Qualification previously granted to a user.

To update a user's Qualification, you must know the user's ID. A Worker's user ID is included in the assignment data returned by the GetAssignmentsForHIT operation.

Only the owner of a Qualification type may update the score of a Qualification of that type.

The user must have already been granted a Qualification of the given Qualification type before the score can be updated.

The following example of a call to the UpdateQualificationScore operation changes the value of a Qualification of the given type for the given user.

http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2006-10-31
&Operation=UpdateQualificationScore
&Signature=[signature for this request]
&Timestamp=[your system's local time]
&QualificationTypeId=789RVWYBAZW00EXAMPLE
&SubjectId=AZ3456EXAMPLE
&IntegerValue=70

A request to the Mechanical Turk Service includes parameters that control its behavior and the data it returns. Required parameters must be included for the request to succeed.

UpdateQualificationScore accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.

The following parameters are specific to the UpdateQualificationScore operation:

NameDescriptionTypeValue
Operation

The operation you would like to call. To access the UpdateQualificationScore operation, set the Operation parameter to UpdateQualificationScore.

Required

UpdateQualificationScore

QualificationTypeId

The ID of the Qualification type, as returned by the CreateQualificationType operation.

Required

A Qualification type ID

SubjectId

The ID of the user whose Qualification is being updated.

A Worker's user ID is returned with assignment data by the GetAssignmentsForHIT operation.

Required

A user ID

IntegerValue

The new value for the Qualification.

Required

An integer

A successful request for the UpdateQualificationScore will return with no errors. The response will include an UpdateQualificationScoreResult element, which contains the request (if the Request response group is specified). The operation returns no other data.