DisassociateQualificationFromWorker - Amazon Mechanical Turk

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

Reason

A text message that explains why the Qualification was revoked. The user who had the Qualification sees this message. IF a reason is not provided, the worker will not be notified.

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>