The DisposeQualificationType operation disposes a Qualification type. Only the owner of the
Qualification type can dispose it.
HIT types that use a disposed Qualification type can no longer be used to create new HITs. If there are active HITs with this Qualification type as a requirement, the HITs remain active. If a Qualification is already assigned to a Worker, the Qualification remains active. If there are any pending requests for the Qualification type, Amazon Mechanical Turk rejects those requests.
Once you dispose a Qualification type, it cannot be used to create HITs or HIT types. HITs that have disposed Qualification types cannot be extended. Operations that require a Qualification type as a parameter will fail if you use a disposed Qualification type for that parameter.
The following example of a call to the DisposeQualificationType operation
disposes the specified Qualification type.
http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID]&Version=2008-04-01 &Operation=DisposeQualificationType &Signature=[signature for this request]&Timestamp=[your system's local time]&QualificationTypeId=789RVWYBAZW00EXAMPLE
A request to the Amazon Mechanical Turk Service includes parameters that control its behavior and the data it returns. Required parameters must be included for the request to succeed.
DisposeQualificationType accepts parameters common to all
operations. Some common parameters are required. See
Common Parameters
for more information.
The following parameters are specific to the
DisposeQualificationType operation:
| Name | Description | Type | Value |
|---|---|---|---|
Operation
|
The operation you want to call. To access the
DisposeQualificationType operation, set the
Operation parameter to
DisposeQualificationType.
| Required |
DisposeQualificationType
|
QualificationTypeId
| The ID of the Qualification type to dispose. | Required | A valid QualificationType ID |
A successful request for the DisposeQualificationType operation
will return with no errors. The response will include a
DisposeQualificationTypeResult element, which contains the
Request (if the Request response group is specified). The
operation returns no other data.