DisposeHIT

Description

The DisposeHIT operation disposes of a HIT that is no longer needed.

You can dispose only HITs in the Reviewable state, with all submitted assignments approved or rejected. If you call the DisposeHIT operation 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 returns an error.

Only the Requester who created a HIT can dispose it.

Request Parameters

The DisposeHIT 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 DisposeHIT operation:

Name Description Required

Name	Description	Required
`Operation`	The name of the operation Type: String Valid Values: DisposeHIT Default: None	Yes
`HitId`	The ID of the HIT, as returned by the CreateHIT operation. Type: String Default: None	Yes

Operation

The name of the operation

Type: String

Valid Values: DisposeHIT

Default: None

Yes

HitId

The ID of the HIT, as returned by the CreateHIT operation.

Type: String

Default: None

Yes

Response Elements

A successful request for the DisposeHIT operation returns with no errors. The response includes the elements described in the following table. The operation returns no other data.

Name	Description
`DisposeHITResult`	Contains a `Request` element if the `Request` `ResposeGroup` is specified.

Examples

The following example shows how to use the DisposeHIT operation.

Sample Request

The following example disposes of the HIT with the specified HIT ID.

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

Sample Response

The following is an example response.

<DisposeHITResult>
  <Request>
    <IsValid>True</IsValid>
  </Request>
</DisposeHITResult>