Amazon Mechanical Turk
API Reference (API Version 2012-03-25)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

UpdateQualificationScore

Description

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

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

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

Request Parameters

The UpdateQualificationScore operation 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:

NameDescriptionRequired

Operation

The name of the operation

Type: String

Valid Values: UpdateQualificationScore

Default: None

Yes

QualificationTypeId

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

Type: String

Default: None

Yes

SubjectId

The ID of the Worker whose Qualification is being updated, as returned by the GetAssignmentsForHIT operation.

Type: String

Default: None

Yes

IntegerValue

The new value for the Qualification.

Type: Integer

Default: None

Yes

Response Elements

A successful request for the UpdateQualificationScore operation returns with no errors. The response includes the elements described in the following table. The operation returns no other data.

NameDescription

UpdateQualificationScoreResult

Contains a Request element if the Request ResponseGroup is specified.

Examples

The following example shows how to use the UpdateQualificationScore operation.

Sample Request

The following example changes the value of a Qualification of the specified type for the specified Worker.

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

Sample Response

The following is an example response.

<UpdateQualificationScoreResult>
  <Request>
    <IsValid>True</IsValid>
  </Request>
</UpdateQualificationScoreResult>