DisassociateQualificationFromWorker - Amazon Mechanical Turk
DescriptionRequest SyntaxRequest ParametersResponse ElementsExample

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>