The UpdateQualificationType operation modifies attributes of an existing Qualification type.
The following attributes of a Qualification type can be updated:
Other attributes, such as the Qualification type's name, cannot be modified after the type has been created. If you create a Qualification type and decide you do not wish to use it with its immutable attributes as they were created, update the type with a new QualificationTypeStatus of Inactive, then create a new type using CreateQualificationType with the desired values.
Only the author of a Qualification type may modify its attributes.
Using UpdateQualificationType (REST)
The following example of a call to the UpdateQualificationType operation changes the QualificationTypeStatus of a Qualification type.
http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID] &Operation=UpdateQualificationType &Signature=[signature for this request] &Timestamp=[your system's local time] &QualificationTypeId=789RVWYBAZW00EXAMPLE &QualificationTypeStatus=Inactive
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.
UpdateQualificationType accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.
The following parameters are specific to the UpdateQualificationType operation:
| Name | Description | Type | Value |
|---|---|---|---|
| Operation |
The operation to call. To access the UpdateQualificationType operation, set the Operation parameter to UpdateQualificationType. |
Required |
UpdateQualificationType |
| QualificationTypeId |
The ID of the Qualification type to update. |
Required |
A valid Qualification type ID |
| QualificationTypeStatus |
The new status of the Qualification type. |
Optional |
Active | Inactive |
| Description |
The new description of the Qualification type. |
Optional |
A string |
A successful request for the UpdateQualificationType operation will have a QualificationType element in the response.
The QualificationType element contains a Qualification type data structure. For a description of this data structure, see the Qualification Type Data Structure.