ExtendHIT

Description

The ExtendHIT operation increases the maximum number of assignments, or extends the expiration date, of an existing HIT.

If a HIT is not assignable (with a status of Unassignable or Reviewable) due to either having reached its maximum number of assignments or having reached its expiration date, extending the HIT can make it available again.

To extend the maximum number of assignments, specify the number of additional assignments.

To extend the expiration date, specify an amount of time as a number of seconds. If the HIT has not yet expired, the new expiration date will be the existing date plus the amount of time specified. If the HIT has already expired, the new expiration date will be the current time plus the amount of time specified.

Note

	Note
If a HIT has a status of `Reviewable` and the HIT is extended to make it `Available`, the HIT will not be returned by `GetReviewableHITs`, and its submitted assignments will not be returned by `GetAssignmentsForHIT`, until the HIT is `Reviewable` again. Assignment auto-approval will still happen on its original schedule, even if the HIT has been extended. Be sure to retrieve and approve (or reject) submitted assignments before extending the HIT, if so desired.

If a HIT has a status of Reviewable and the HIT is extended to make it Available, the HIT will not be returned by GetReviewableHITs, and its submitted assignments will not be returned by GetAssignmentsForHIT, until the HIT is Reviewable again. Assignment auto-approval will still happen on its original schedule, even if the HIT has been extended. Be sure to retrieve and approve (or reject) submitted assignments before extending the HIT, if so desired.

Only the Requester who created a HIT can extend it.

Sample Request: Using ExtendHIT (REST)

The following example of a call to the ExtendHIT operation extends the expiration date of a HIT by 5 days (432,000 seconds).

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

Request Parameters

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.

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

The following parameters are specific to the ExtendHIT operation:

Name	Description	Type	Value
`Operation`	The operation you would like to call. To access the `ExtendHIT` operation, set the `Operation` parameter to `ExtendHIT`.	Required	`ExtendHIT`
`HITId`	The ID of the HIT to extend.	Required	A valid HIT ID
`MaxAssignmentsIncrement`	The number of assignments by which to increment the HIT's `MaxAssignments`. If the HIT was previously unavailable because the maximum number of Workers had accepted the HIT and submitted results, the HIT will become available again until the new maximum has been reached, or the expiration date has passed. `MaxAssignmentsIncrement` must be an integer between 1 and 1000000000 (1 billion).	Optional	A positive integer
`ExpirationIncrementInSeconds`	The amount of time to extend the expiration date, in seconds. If the HIT has not yet expired, this amount is added to the HIT's expiration date. If the HIT has expired, the new expiration date is the current time plus this value. `ExpirationIncrementInSeconds` must be an integer between 3600 (1 hour) and 31536000 (365 days).	Optional	A number of seconds, as a positive integer

Responses

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