ForceExpireHIT

The ForceExpireHIT operation causes a HIT to expire immediately, as if the HIT's LifetimeInSeconds had elapsed.

The effect is identical to the HIT expiring on its own: The HIT no longer appears on the Mechanical Turk web site, and no new Workers are allowed to accept the HIT. Workers who have accepted the HIT prior to expiration are allowed to complete it or return it, or allow the assignment duration to elapse (abandon the HIT). Once all remaining assignments have been submitted, the expired HIT becomes "reviewable", and will be returned by a call to GetReviewableHITs.

Tip:

Unlike DisableHIT, ForceExpireHIT does not have any effect on assignments. If assignments have been submitted for the HIT, your application will still need to approve or reject them before disposing of the HIT.

The following example of a call to the ForceExpireHIT operation causes a HIT to expire.

http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Operation=ForceExpireHIT
&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.

ForceExpireHIT accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.

The following parameters are specific to the ForceExpireHIT operation:

NameDescriptionTypeValue
Operation

The operation you would like to call. To access the ForceExpireHIT operation, set the Operation parameter to ForceExpireHIT.

Required

ForceExpireHIT

HITId

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

Required

A valid HIT ID

A successful request for the ForceExpireHIT operation will return with no errors. The response will include a ForceExpireHITResult element, which contains the request (if the Request response group is specified). The operation returns no other data.