SetWorkerAcceptLimit

Description

THIS OPERATION IS BEING DEPRECATED AS OF 10/6/2008. PLEASE REFRAIN FROM USING IT. You can no longer set the accept limit. Amazon Mechanical Turk enforces a limit of ten assignments per worker at any one time.

The SetWorkerAcceptLimit operation sets the maximum number of assignments for your HITs that any Worker can accept. See also Specifying the Number of Assignments a Worker Can Accept.

This operation lets you set two types of limits:

  • The maximum number of assignments any Worker can accept for a specific HIT type you've created. This value is undefined until you set it.

  • The maximum number of assignments any Worker can accept for all your HITs that don't otherwise have a HIT-type-specific limit already assigned. The initial default value is 10.

Example

You can change the limit for all your HITs, regardless of HIT type. For example, you could set the limit to 25:


Set the limit for all your HITs

Example

You can also change the limit for specific HIT types. You could request SetWorkerAcceptLimit and set the limit to 1 for HITs of type A:


Set limit for specific HIT types

In the above example, the maximum number of assignments a Worker can accept for your HITs is:

1 (max for HIT type A) + 10 (max for the rest of your HITs) = 11.

Example

You could change the limit to 40 for the remaining HITs by calling SetWorkerAcceptLimit with the LimitGroupType set to Default.


Set the limit for remaining HITs

Now, the maximum number of assignments a Worker can accept for your HITs is:

1 (max for HIT type A) + 40 (max for the rest of your HITs) = 41

Sample Request: Using SetWorkerAcceptLimit (REST)

The following example of a call to the SetWorkerAcceptLimit operation sets the limit to 1 for HITs of type T100CN9P324W00EXAMPLE.

http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2008-04-01
&Operation=SetWorkerAcceptLimit
&Signature=[signature for this request]
&Timestamp=[your system's local time]
&MaxWorkerAcceptLimit=1
&LimitGroupType=HIT Type
&LimitGroupID=T100CN9P324W00EXAMPLE

Request Parameters

A request to the Amazon Mechanical Turk service includes parameters that control its behavior and the data it returns. Required parameters must be included for the request to succeed.

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

The following parameters are specific to the SetWorkerAcceptLimit operation:

NameDescriptionTypeValue
Operation

The operation you want to call. To access the SetWorkerAcceptLimit operation, set the Operation parameter to SetWorkerAcceptLimit.

Required

SetWorkerAcceptLimit

MaxWorkerAcceptLimit

The maximum number of assignments a Worker can accept.

Required

A positive integer

LimitGroupType

The type of group you want to set the limit on; either HIT Type (for a specific HIT type) or Default (for all your HITs that don't otherwise have a HIT-type-specific limit assigned).

Required

HIT Type | Default

LimitGroupID

The ID of the HIT type you want to limit. For the request to succeed, you must be the creator of this HIT type.

Required when LimitGroupType = HIT Type

A valid HIT type you created

Responses

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

Related Operations

GetWorkerAcceptLimit