AssociateQualificationWithWorker

Description

The AssociateQualificationWithWorker operation gives a Worker a Qualification. AssociateQualificationWithWorker does not require that the Worker submit a Qualification request. It immediately gives the Worker the Qualification.

You can only assign a Qualification of a Qualification type that you created (using the CreateQualificationType operation).

Tip

AssociateQualificationWithWorker does not affect any pending Qualification requests for the Qualification by the Worker. If you associate a Qualification to a Worker, then later accept a Qualification request made by the Worker, accepting the request may modify the Qualification score. To resolve a pending Qualification request without affecting the Qualification the Worker already has, reject the request with the RejectQualificationRequest operation.

Request Syntax

{ 
  "QualificationTypeId": String,

  "WorkerId": String,

  "IntegerValue": Integer,

  "SendNotification": Boolean
 }

Request Parameters

The request accepts the following data in JSON format:

Name	Description	Required
QualificationTypeId	The ID of the Qualification type to use for the assigned Qualification. Type: String Constraints: must be a valid Qualification type ID, as returned by the CreateQualificationType operation.	Yes
WorkerId	The ID of the Worker to whom the Qualification is being assigned. Worker IDs are included with submitted HIT assignments and Qualification requests. Type: String	Yes
IntegerValue	The value of the Qualification to assign. Type: Integer Default: 1	Yes
SendNotification	Specifies whether to send a notification email message to the Worker saying that the qualification was assigned to the Worker. Type: Boolean Default: true	No

Response Elements

A successful request for the AssociateQualificationWithWorker operation returns with no errors and an empty body.

Example

The following example shows how to use the AssociateQualificationWithWorker operation:

Sample Request

The following example grants a Qualification to a Worker.

POST / HTTP/1.1
Host: mturk-requester.us-east-1.amazonaws.com
Content-Length: <PayloadSizeBytes>
X-Amz-Date: <Date>
{
  WorkerId:"AZ3456EXAMPLE",
  QualificationTypeId:"789RVWYBAZW00EXAMPLE",
  IntegerValue:1,
  SendNotification:false
}

Sample Response

The following is an example response:

HTTP/1.1 200 OK
x-amzn-RequestId: <RequestId>
Content-Type: application/x-amz-json-1.1
Content-Length: <PayloadSizeBytes>
Date: <Date>