The DisposeHIT operation disposes of a HIT
that is no longer needed.
Only HITs in the "reviewable" state, with all submitted
assignments approved or rejected, can be disposed. A Requester
can call GetReviewableHITs to determine
which HITs are reviewable, then call
GetAssignmentsForHIT to retrieve the
assignments. Disposing of a HIT removes the HIT from the
results of a call to GetReviewableHITs.
If DisposeHIT is called on a HIT that is
not "reviewable" (that has not expired or has active
assignments), or on a HIT that is "reviewable" but not all of
the submitted assignments have been approved or rejected, the
service will return an error.
Tip: |
To prevent Workers from accepting a HIT that is still available,
call the |
Only the Requester who created a HIT may dispose it.
The following example of a call to the
DisposeHIT operation disposes of the HIT
with the given HIT ID.
http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID]&Version=2006-10-31 &Operation=DisposeHIT &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.
DisposeHIT accepts parameters common to all
operations. Some common parameters are required. See Common Parameters for more information.
The following parameters are specific to the
DisposeHIT 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 |