|  | 
| --- |
| **This software is not currently supported by Amazon Mechanical Turk** The Amazon Mechanical Turk Command Line Tools (CLT) are not currently maintained by Amazon Mechanical Turk. If you would still like to use Amazon Mechanical Turk from the command line, use the `mturk` command in the AWS Command Line Interface (CLI). For more information, see the `mturk` section of the [ AWS CLI Command Reference ](https://docs.aws.amazon.com/cli/latest/reference/mturk/index.html).  | 

 

# assignQualification
<a name="CLTReference_AssignQualificationCommand"></a>

## Description
<a name="w2aab9c13b2"></a>

 The `assignQualification` command assigns a Qualification to a Worker without the Worker requesting the Qualification. There are two ways to use this operation: 
+ **Bulk Operation—** If you want to assign multiple Qualifications, use this command with a file that contains the Qualification Type ID and the list of Workers to be assigned the Qualfication.
+ **Single Assignmentn—** You can specify the Qualification Type ID, the Worker, and the assigned Qualification score on the command line.

## Arguments
<a name="w2aab9c13b4"></a>

 The following table describes the arguments for the `assignQualification` command. 


| Name | Description | Required | 
| --- | --- | --- | 
|  `-donotnotify`  |   Specifies not to notify Workers when you have assigned them the Qualification.  Example: `-donotnotify`  |  No  | 
|  `-help` or `-h`  |   Displays the help for this operation.  Example: `-help`  |  No  | 
|  `-input [filename] `  |   Specifies the file that contains the Qualification ID you want to assign to Workers. This file contains a single Qualification ID. You can find this ID in the `.success` file generated after you create the Qualification with the [createQualificationType](CLTReference_CreateQualificationTypeCommand.md) operation. For information about this file, see *The Qualification ID file* in [Files Used by the Command Line Tools](CLTFilesArticle.md).  Condition: Required if the `qualtypeid` argument is not specified. Example: `-input qualification.properties.success`  |  Conditional  | 
|  `-qualtypeid [Qualification Type ID]`  |   Specifies the Qualification Type ID of the Qualification you want to assign to the Worker. This ID can be found in the `.success` file generated after you create the Qualification with the `>` operation.  Condition: Required if the `input` argument is not specified. Example: `-qualtypeid RWFZTKZ55ZPZXN1C8TDZ`  |  Conditional  | 
|  `-sandbox`  |   Runs this command in the Amazon Mechanical Turk sandbox for testing. This argument takes precedence even if you specify the production web site in your `mturk.properties` file.   Example:`-sandbox`   |  No  | 
|  `-score [integer]`  |   Specifies the default Qualification score to assign to Workers. This argument can be used with both the bulk operation and the single assignment. If this argument is not specified, and the score has not been defined in the scorefile, a default score of `1` is used.  Example: `-score 100`  |  No  | 
|  `-scorefile [filename] `  |   Specifies a file which contains a tab delimited list of Worker IDs and optional Qualification scores to assign to each Worker. If the score is not specified, a default value of `1` is assigned. For information about this file, see *The score file* in [Files Used by the Command Line Tools](CLTFilesArticle.md).  Condition: Required if the `-workerid` argument is not specified. Example: `-scorefile workerstoassign.txt`  |  Conditional  | 
|  `-workerid [Worker ID]`  |   Specifies the ID of the Worker you want to assign the Qualification to.  Condition: Required if the `scorefile` argument is not specified. Example: `-workerid A3C4G8DMXFG5PQ`  |  Conditional  | 

## Example
<a name="w2aab9c13b6"></a>

 The following examples for Unix and Windows show how to use the `AssignQualification` command. The examples demonstrate a single assignment. 

### Unix
<a name="w2aab9c13b6b4"></a>

 The following example demonstrates how to call this command from Unix. 

```
./assignQualification.sh -qualtypeid RWFZTKZ55ZPZXN1C8TDZ -workerid A3C4G8DMXFG5PQ -score 100
```

### Windows
<a name="w2aab9c13b6b6"></a>

 The following example demonstrates how to call this command from Microsoft Windows. 

```
assignQualification -qualtypeid RWFZTKZ55ZPZXN1C8TDZ -workerid A3C4G8DMXFG5PQ -score 100
```

## Output
<a name="w2aab9c13b8"></a>

These examples produce the following output.

```
Assigned qualification RWFZTKZ55ZPZXN1C8TDZ to A3C4G8DMXFG5PQ with value 100
```

## Related Commands
<a name="w2aab9c13c10"></a>

 
+  [createQualificationType](CLTReference_CreateQualificationTypeCommand.md)