The RejectAssignment operation rejects the results of a completed assignment.
Rejecting an assignment indicates that the Requester believes the results submitted by the Worker do not properly answer the question described by the HIT. The Worker is not paid for a rejected assignment.
If the HIT has not yet expired, rejecting the results of an assignment makes another assignment available for other Workers to accept. Because a Worker may only accept a HIT once, the Worker who submitted the rejected results will not be allowed to accept this HIT again.
Only the Requester who created the HIT can reject assignments for the HIT.
Calling RejectAssignment on an assignment that has not yet been submitted will return an error.
Using RejectAssignment (REST)
The following example of a call to the RejectAssignment operation rejects an assignment identified by its assignment ID.
http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID] &Operation=RejectAssignment &Signature=[signature for this request] &Timestamp=[your system's local time] &AssignmentId=123RVWYBAZW00EXAMPLE456RVWYBAZW00EXAMPLE
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.
RejectAssignment accepts parameters common to all operations. Some common parameters are required. See Common Parameters for more information.
The following parameters are specific to the RejectAssignment operation:
| Name | Description | Type | Value |
|---|---|---|---|
| Operation |
The operation to call. To access the RejectAssignment operation, set the Operation parameter to RejectAssignment. |
Required |
RejectAssignment |
| AssignmentId |
The assignment ID. The assignment must correspond to a HIT created by the Requester for the call to RejectAssignment to succeed. |
Required |
A valid assignment ID |
A successful request for the RejectAssignment operation will return with no errors. The response will include a RejectAssignmentResult element, which contains the Request (if the Request response group is specified). The operation returns no other data.