Amazon Mechanical Turk · JSON Structure

Amazon Mechanical Turk Create Qualification Type Request Structure

CreateQualificationTypeRequest schema from Amazon Mechanical Turk API

Type: object Properties: 10 Required: 3
CrowdsourcingHuman IntelligenceLaborMachine LearningTasks

CreateQualificationTypeRequest is a JSON Structure definition published by Amazon Mechanical Turk, describing 10 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

Name Keywords Description QualificationTypeStatus RetryDelayInSeconds Test AnswerKey TestDurationInSeconds AutoGranted AutoGrantedValue

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-mechanical-turk/refs/heads/main/json-structure/amazon-mechanical-turk-create-qualification-type-request-structure.json",
  "name": "CreateQualificationTypeRequest",
  "description": "CreateQualificationTypeRequest schema from Amazon Mechanical Turk API",
  "type": "object",
  "properties": {
    "Name": {
      "allOf": [
        {
          "$ref": "#/components/schemas/String"
        },
        {
          "description": " The name you give to the Qualification type. The type name is used to represent the Qualification to Workers, and to find the type using a Qualification type search. It must be unique across all of your Qualification types."
        }
      ]
    },
    "Keywords": {
      "allOf": [
        {
          "$ref": "#/components/schemas/String"
        },
        {
          "description": "One or more words or phrases that describe the Qualification type, separated by commas. The keywords of a type make the type easier to find during a search."
        }
      ]
    },
    "Description": {
      "allOf": [
        {
          "$ref": "#/components/schemas/String"
        },
        {
          "description": "A long description for the Qualification type. On the Amazon Mechanical Turk website, the long description is displayed when a Worker examines a Qualification type."
        }
      ]
    },
    "QualificationTypeStatus": {
      "allOf": [
        {
          "$ref": "#/components/schemas/QualificationTypeStatus"
        },
        {
          "description": "<p>The initial status of the Qualification type.</p> <p>Constraints: Valid values are: Active | Inactive</p>"
        }
      ]
    },
    "RetryDelayInSeconds": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Long"
        },
        {
          "description": "<p>The number of seconds that a Worker must wait after requesting a Qualification of the Qualification type before the worker can retry the Qualification request.</p> <p>Constraints: None. If not specified, retries are disabled and Workers can request a Qualification of this type only once, even if the Worker has not been granted the Qualification. It is not possible to disable retries for a Qualification type after it has been created with retries enabled. If you want to disable retries, you must delete existing retry-enabled Qualification type and then create a new Qualification type with retries disabled.</p>"
        }
      ]
    },
    "Test": {
      "allOf": [
        {
          "$ref": "#/components/schemas/String"
        },
        {
          "description": "<p> The questions for the Qualification test a Worker must answer correctly to obtain a Qualification of this type. If this parameter is specified, <code>TestDurationInSeconds</code> must also be specified. </p> <p>Constraints: Must not be longer than 65535 bytes. Must be a QuestionForm data structure. This parameter cannot be specified if AutoGranted is true.</p> <p>Constraints: None. If not specified, the Worker may request the Qualification without answering any questions.</p>"
        }
      ]
    },
    "AnswerKey": {
      "allOf": [
        {
          "$ref": "#/components/schemas/String"
        },
        {
          "description": "<p>The answers to the Qualification test specified in the Test parameter, in the form of an AnswerKey data structure.</p> <p>Constraints: Must not be longer than 65535 bytes.</p> <p>Constraints: None. If not specified, you must process Qualification requests manually.</p>"
        }
      ]
    },
    "TestDurationInSeconds": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Long"
        },
        {
          "description": "The number of seconds the Worker has to complete the Qualification test, starting from the time the Worker requests the Qualification."
        }
      ]
    },
    "AutoGranted": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Boolean"
        },
        {
          "description": "<p>Specifies whether requests for the Qualification type are granted immediately, without prompting the Worker with a Qualification test.</p> <p>Constraints: If the Test parameter is specified, this parameter cannot be true.</p>"
        }
      ]
    },
    "AutoGrantedValue": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Integer"
        },
        {
          "description": "The Qualification value to use for automatically granted Qualifications. This parameter is used only if the AutoGranted parameter is true."
        }
      ]
    }
  },
  "required": [
    "Name",
    "Description",
    "QualificationTypeStatus"
  ]
}