ExtendHIT

Prev		Next

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:

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/onca/xml?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2006-08-23
&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.	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.	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.