Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

AssociateQualificationWithWorker

Focus mode
AssociateQualificationWithWorker - Amazon Mechanical Turk

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>
PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.