ApproveAssignment

The ApproveAssignment operation approves the results of a completed assignment.

Approving an assignment initiates two payments from the Requester's Amazon.com account: the Worker that submitted the results is paid the reward specified in the HIT, and Mechanical Turk fees are debited. If the Requester's account does not have adequate funds for these payments, the call to ApproveAssignment will return an exception, and the approval will not be processed.

You can include an optional feedback message with the approval, which the Worker can see in the "status" section of the web site.

The following example of a call to the ApproveAssignment operation approves an assignment identified by its assignment ID.

http://mechanicalturk.amazonaws.com/onca/xml?Service=AWSMechanicalTurkRequester
&AWSAccessKeyId=[the Requester's Access Key ID]
&Version=2006-10-31
&Operation=ApproveAssignment
&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.

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

The following parameters are specific to the ApproveAssignment operation:

NameDescriptionTypeValue
Operation

The operation to call. To access the ApproveAssignment operation, set the Operation parameter to ApproveAssignment.

Required

ApproveAssignment

AssignmentId

The assignment ID. The assignment must correspond to a HIT created by the Requester for the call to ApproveAssignment to succeed.

Required

A valid assignment ID

RequesterFeedback

A message for the Worker, which the Worker can see in the "status" section of the web site. The message can be up to 1024 characters (including multi-byte characters).

Optional

A string

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