RevokeQualification

Prev		Next

Description

The RevokeQualification operation revokes a previously granted Qualification from a user. If the user had a Qualification of the given Qualification type, after revoking it, the user will no longer have the Qualification, and will not qualify for HITs whose Qualification requirements say the user must have the Qualification.

Once a Qualification is revoked from a user, the user cannot be granted the Qualification until the user requests the Qualification again. Depending on how the Qualification type's retry policy is configured, the user may be restricted from requesting the Qualification a second time.

You can optionally include a "reason," a text message explaining why the Qualification was revoked that the user that had the Qualification will see.

Sample Request: Using RevokeQualification (REST)

The following example of a call to the RevokeQualification operation revokes a given user's Qualification of the given Qualification type.

http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2006-10-31
&Operation=RevokeQualification
&Signature=[signature for this request]
&Timestamp=[your system's local time]
&SubjectId=AZ3456EXAMPLE
&QualificationTypeId=789RVWYBAZW00EXAMPLE

Request Parameters

A request to the Mechanical Turk Service includes parameters that control its behavior and the data it returns. Required parameters must be included for the request to succeed.

RevokeQualification accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.

The following parameters are specific to the RevokeQualification operation:

Name	Description	Type	Value
`Operation`	The operation you would like to call. To access the `RevokeQualification` operation, set the `Operation` parameter to `RevokeQualification`.	Required	`RevokeQualification`
`SubjectId`	The ID of the user (such as the Worker) possessing the Qualification to be revoked.	Required	A valid user ID
`QualificationTypeId`	The ID of the Qualification type of the Qualification to be revoked.	Required	A valid Qualification type ID
`Reason`	A text message explaining why the Qualification was revoked, which the user that had the Qualification will see. This parameter is optional.	Optional	A string

Responses

A successful request for the RevokeQualification operation will return with no errors. The response will include an RevokeQualificationResult element, which contains the Request (if the Request response group is specified). The operation returns no other data.