SetWorkerAcceptLimit
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:
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:
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.
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
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=2007-03-12 &Operation=SetWorkerAcceptLimit &Signature=[signature for this request]&Timestamp=[your system's local time]&MaxWorkerAcceptLimit=1 &LimitGroupType=HIT Type &LimitGroupID=T100CN9P324W00EXAMPLE
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:
| Name | Description | Type | Value |
|---|---|---|---|
Operation
|
The operation you want to call. To access the
| Required |
|
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 | Required |
|
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 |
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.