Amazon Mechanical Turk
API Reference (API Version 2017-01-17)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

DisassociateQualificationFromWorker

Description

The DisassociateQualificationFromWorker revokes a previously granted Qualification from a user.

You can provide a text message explaining why the Qualification was revoked. The user who had the Qualification can see this message.

Request Syntax

{ "QualificationTypeId": String, "WorkerId": String, "IntegerValue": Integer, "Reason": String }

Request Parameters

The request accepts the following data in JSON format:

Name Description Required

QualificationTypeId

The ID of the Qualification type of the Qualification to be revoked.

Type: String

Yes

WorkerId

The ID of the Worker who possesses the Qualification to be revoked.

Type: String

Yes

IntegerValue

The value of the Qualification to assign.

Type: Integer

Default: 1

Yes

Reason

A text message that explains why the Qualification was revoked. The user who had the Qualification sees this message.

Type: String

No

Response Elements

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

Example

The following example shows how to use the DisassociateQualificationFromWorker operation:

Sample Request

The following example revokes Qualification of the specified Qualification type for the specified user.

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, }

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>