The DisableHIT
operation removes a HIT from the Amazon
Mechanical Turk marketplace, approves all submitted assignments that have not already
been approved or rejected, and disposes of the HIT and all assignment data.
Assignments for the HIT that have already been submitted, but not yet approved or
rejected, are automatically approved. Assignments in progress at the time of the call to
the DisableHIT
operation are approved once the assignments are
submitted. You will be charged for approval of these assignments.
Caution | |
---|---|
The |
The DisableHIT
operation completely disposes of the HIT and all
submitted assignment data. Assignment results data cannot be retrieved for a HIT that
has been disposed.
Only the Requester who created a HIT can disable it.
The DisableHIT
operation accepts parameters common to all
operations. Some common parameters are required. See Common Parameters for more information.
The following parameters are specific to the DisableHIT
operation:
Name | Description | Required |
---|---|---|
|
The name of the operation Type: String Valid Values: DisableHIT Default: None |
Yes |
|
The ID of the HIT, as returned by the CreateHIT operation. Type: String Default: None |
Yes |
A successful request for the DisableHIT
operation returns with
no errors. The response includes the elements in the following table. The operation
returns no other data.
Name | Description |
---|---|
|
Contains a |
The following example shows how to use the DisableHIT
operation.
The following example disables a HIT with a specified HIT ID.
http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2008-08-02 &Operation=DisableHIT &Signature=[signature for this request]
&Timestamp=[your system's local time]
&HITId=123RVWYBAZW00EXAMPLE
The following is an example response.
<DisableHITResult> <Request> <IsValid>True</IsValid> </Request> </DisableHITResult>