RejectAssignment

Description

The RejectAssignment operation rejects the results of a completed assignment.

You can include an optional feedback message with the rejection, which the Worker can see in the Status section of the web site. When you include a feedback message with the rejection, it helps the Worker understand why the assignment was rejected, and can improve the quality of the results the Worker submits in the future.

Only the Requester who created the HIT can reject an assignment for the HIT.

Request Parameters

The RejectAssignment operation 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:

NameDescriptionRequired

Operation

The name of the operation

Type: String

Valid Values: RejectAssignment

Default: None

Yes

AssignmentId

The assignment ID

Type: String

Default: None

Yes

RequesterFeedback

A message for the Worker, which the Worker can see in the Status section of the web site.

Type: String

Default: None

Constraints: can be up to 1024 characters, including multi-byte characters.

No

Response Elements

A successful request for the RejectAssignment operation returns with no errors. The response includes the elements described in the following table. The operation returns no other data.

NameDescription

RejectAssignmentResult

Contains a Request element if the Request ResposeGroup is specified.

Examples

The following example shows how to use the RejectAssignment operation.

Sample Request

The following example rejects an assignment identified by its assignment ID.

http://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2008-08-02
&Operation=RejectAssignment
&Signature=[signature for this request]
&Timestamp=[your system's local time]
&AssignmentId=123RVWYBAZW00EXAMPLE456RVWYBAZW00EXAMPLE
          

Sample Response

The following is an example response.

<RejectAssignmentResult>
  <Request>
    <IsValid>True</IsValid>
  </Request>
</RejectAssignmentResult>