Amazon Mechanical Turk will permanently close on September 30, 2026. For Workers and Requesters currently using the service, visit our Amazon Mechanical Turk help page
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 |
|---|---|---|
|
|
The ID of the Qualification type of the Qualification to be revoked. Type: String |
Yes |
|
|
The ID of the Worker who possesses the Qualification to be revoked. Type: String |
Yes |
|
|
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>
