AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

The CreateHIT operation creates a new Human Intelligence Task (HIT). The new HIT is made available for Workers to find and accept on the Amazon Mechanical Turk website.

This operation allows you to specify a new HIT by passing in values for the properties of the HIT, such as its title, reward amount and number of assignments. When you pass these values to CreateHIT, a new HIT is created for you, with a new HITTypeID. The HITTypeID can be used to create additional HITs in the future without needing to specify common parameters such as the title, description and reward amount each time.

An alternative way to create HITs is to first generate a HITTypeID using the CreateHITType operation and then call the CreateHITWithHITType operation. This is the recommended best practice for Requesters who are creating large numbers of HITs.

CreateHIT also supports several ways to provide question data: by providing a value for the Question parameter that fully specifies the contents of the HIT, or by providing a HitLayoutId and associated HitLayoutParameters.

If a HIT is created with 10 or more maximum assignments, there is an additional fee. For more information, see Amazon Mechanical Turk Pricing.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateHITAsync.

Namespace: Amazon.MTurk
Assembly: AWSSDK.MTurk.dll
Version: 3.x.y.z

Syntax

C#
public abstract CreateHITResponse CreateHIT(
         CreateHITRequest request
)

Parameters

request
Type: Amazon.MTurk.Model.CreateHITRequest

Container for the necessary parameters to execute the CreateHIT service method.

Return Value


The response from the CreateHIT service method, as returned by MTurk.

Exceptions

ExceptionCondition
RequestErrorException Your request is invalid.
ServiceException Amazon Mechanical Turk is temporarily unable to process your request. Try your call again.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also