ChangeHITTypeOfHIT

Description

The ChangeHITTypeOfHIT operation allows you to change the HITType properties of a HIT. This operation disassociates the HIT from its old HITType properties and associates it with the new HITType properties. The HIT takes on the properties of the new HITType in place of the old ones. For more information about HIT types, see HIT Types.

You can use ChangeHITTypeOfHIT to update any of the HITType properties of a HIT. All properties except for Reward can be updated at any time.

For example, if you want to change the Title property of your HIT, perform the following steps:

Use the GetHIT operation to get the HIT. This operation returns a HIT Data Structure.
Call the RegisterHITType operation with your new HITType properties. Use your new Title property with the same HITType properties (Description, Keywords, Reward, etc.) as your current HIT. This operation returns a HITTypeId.
Call the ChangeHITTypeOfHIT operation with the HITId and the new HITTypeId properties.

If you want to change the Reward property of a HIT, the HIT cannot have any assignments that are accepted, submitted, approved, or rejected. To change the Reward property of a HIT, perform the following steps:

Use the GetHIT operation to get the HIT. This operation returns a HIT Data Structure.
Verify that you can change the Reward property. If the MaxAssignments property is equal to the NumberOfAssignmentsAvailable property you can change the Reward amount for the HIT. If these properties are not equal and you try to change the Reward amount, the operation fails.
Call the RegisterHITType operation with your new HITType properties. Use your new Reward property with the same HITType properties ( Title, Description, Keywords, etc.) as your current HIT. This operation returns a HITTypeId.
Call the ChangeHITTypeOfHIT operation with the HITId and the new HITTypeId properties.

If you change the Reward amount of a HIT, you must have sufficient funds in your account. Use the GetAccountBalance operation to check the balance of your account.

Sample Request: Using ChangeHITTypeOfHIT (REST)

The following example of a call to the ChangeHITTypeOfHIT operation changes the HIT type.

http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2008-04-01
&Operation=ChangeHITTypeOfHIT
&Signature=[signature for this request]
&Timestamp=[your system's local time]
&HITId=123RVWYBAZW00EXAMPLE
&HITTypeId=T100CN9P324W00EXAMPLE

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.

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

The following parameters are specific to the ChangeHITTypeOfHIT operation:

Name	Description	Type	Value
`Operation`	The operation to call. To access the `ChangeHITTypeOfHIT` operation, set the `Operation` parameter to `ChangeHITTypeOfHIT`.	Required	`ChangeHITTypeOfHIT`
`HITId`	The ID of the HIT to change.	Required	A valid HIT ID
`HITType Id`	The ID of the new HIT type.	Required	A valid HIT type ID

Responses

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