Amazon Mechanical Turk
API Reference (API Version 2017-01-17)

DeleteHIT

Description

The DeleteHIT operation disposes of a HIT that is no longer needed. Only the Requester who created the HIT can delete it.

You can only dispose of HITs that are in the Reviewable state, with all of their submitted assignments already either approved or rejected. If you call the DeleteHIT operation on a HIT that is not in the Reviewable state (for example, that has not expired, or still has active assignments), or on a HIT that is Reviewable but without all of its submitted assignments already approved or rejected, the service returns an error.

Note

  • HITs are automatically disposed of after 120 days.

  • After you dispose of a HIT, you can no longer approve the HIT's rejected assignments.

  • Disposed of HITs are not returned in results for the SearchHITs operation.

  • Disposing of HITs can improve the performance of operations such as ListReviewableHITs and ListHITs.

Request Syntax

{ "HitId": String }

Request Parameters

The request accepts the following data in JSON format:

Name Description Required

HitId

The ID of the HIT.

Type: String

Yes

Response Elements

A successful request for the DeleteHIT operation returns with no errors and an empty body.

Example

The following example shows how to use the DeleteHIT operation:

Sample Request

The following example deletes a HIT with the specified HIT ID.

POST / HTTP/1.1 Host: mturk-requester.us-east-1.amazonaws.com Content-Length: <PayloadSizeBytes> X-Amz-Date: <Date> { HITId:"789RVWYBAZW00EXAMPLE951RVWYBAZW00EXAMPLE" }

Sample Response

The following is an example response:

HTTP/1.1 200 OK x-amzn-RequestId: <RequestId> Content-Type: application/x-amz-json-1.1 Content-Length: <PayloadSizeBytes> Date: <Date>