GrantQualification

The GrantQualification operation grants a user's request for a Qualification.

Only the author of the Qualification type can grant a Qualification request for that type.

The following example of a call to the GrantQualification operation grants a Qualification to a user.

http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2006-08-23
&Operation=GrantQualification
&Signature=[signature for this request]
&Timestamp=[your system's local time]
&QualificationRequestId=789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE
&IntegerValue=95

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.

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

The following parameters are specific to the GrantQualification operation:

NameDescriptionTypeValue
Operation

The operation to call. To access the GrantQualification operation, set the Operation parameter to GrantQualification.

Required

GrantQualification

QualificationRequestId

The ID of the Qualification request, as returned by GetQualificationRequests.

Required

A valid Qualification request ID

IntegerValue

The value of the Qualification. The value must be an integer.

The value is optional. If no value is provided, the Qualification will be granted with an integer value of 1. You can omit the value if you will be using the presence or absence of the Qualification as the basis for a HIT requirement.

Optional

An integer

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