The DisableHIT operation removes a HIT from
the 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, will be automatically approved.
Assignments in progress at the time of the call to
DisableHIT will be approved once the
assignments are submitted. You will be charged for approval of
these assignments.
Caution: |
As of June 14, 2006, |
DisableHIT completely disposes of the HIT
and all submitted assignment data. Assignment results data
cannot be retrieved for a HIT that has been disposed.
It is not possible to re-enable a HIT once it has been disabled. To make the work from a disabled HIT available again, create a new HIT.
Only the Requester who created a HIT may disable it.
The following example of a call to the
DisableHIT operation disables a HIT with
a given HIT ID.
http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID]&Version=2006-08-23 &Operation=DisableHIT &Signature=[signature for this request]&Timestamp=[your system's local time]&HITId=123RVWYBAZW00EXAMPLE
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.
DisableHIT 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 | Type | Value |
|---|---|---|---|
Operation
|
The operation to call. To access the
| Required |
|
HITId
|
The ID of the HIT, as returned by the
| Required |
A valid HIT ID |
A successful request for the DisableHIT
operation will have a HIT element in the
response.
The HIT element contains a HIT data
structure. For a description of the HIT data structure as it
appears in responses, see the HIT Data
Structure.