Skip to main content
POST
/
assessment-tests
/
{assessmentTestIdentifier}
/
test-parts
Create a new test part in an assessment test
curl --request POST \
  --url https://qti.alpha-1edtech.ai/api/assessment-tests/{assessmentTestIdentifier}/test-parts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifier": "<string>",
  "navigationMode": "linear",
  "submissionMode": "individual",
  "qti-assessment-section": [
    {
      "identifier": "<string>",
      "title": "<string>",
      "visible": true,
      "required": true,
      "fixed": false,
      "sequence": 123,
      "qti-assessment-item-ref": [
        {
          "identifier": "<string>",
          "href": "<string>"
        }
      ]
    }
  ]
}
'
{
  "identifier": "<string>",
  "navigationMode": "linear",
  "submissionMode": "individual",
  "qti-assessment-section": [
    {
      "identifier": "<string>",
      "title": "<string>",
      "visible": true,
      "required": true,
      "fixed": false,
      "sequence": 123,
      "qti-assessment-item-ref": [
        {
          "identifier": "<string>",
          "href": "<string>"
        }
      ]
    }
  ],
  "rawXml": "<string>",
  "content": {
    "qti-test-part": {
      "_attributes": {
        "identifier": "<string>",
        "navigation-mode": "<string>",
        "submission-mode": "<string>"
      },
      "qti-assessment-section": [
        {
          "_attributes": {
            "identifier": "<string>",
            "title": "<string>",
            "visible": "<string>",
            "required": "<string>",
            "fixed": "<string>"
          },
          "qti-assessment-item-ref": [
            {
              "_attributes": {
                "identifier": "<string>",
                "href": "<string>"
              }
            }
          ]
        }
      ]
    }
  }
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

assessmentTestIdentifier
string
required

The unique identifier of the parent assessment test where the test part will be created

Body

application/json

The test part to create

Create a new test part on the service provider. A test part must contain at least one assessment section, and the navigation and submission modes must be specified.

identifier
string
required

Unique identifier for the entity on the service provider.

navigationMode
enum<string>
required

Controls how learners navigate through the test part. 'linear' requires items to be responded to in sequence without jumping around, while 'nonlinear' allows candidates to respond to items in any order they choose.

Available options:
linear,
nonlinear
submissionMode
enum<string>
required

Determines how learner responses are submitted for response processing. 'individual' allows responses to be submitted as each item is completed, while 'simultaneous' means responses for all items are sent when the whole part is completed.

Available options:
individual,
simultaneous
qti-assessment-section
object[]
required

Response

Test part created successfully

Response data returned after successfully creating a new test part. Includes the generated XML and parsed content structure.

identifier
string
required

Unique identifier for the entity on the service provider.

navigationMode
enum<string>
required

Controls how learners navigate through the test part. 'linear' requires items to be responded to in sequence without jumping around, while 'nonlinear' allows candidates to respond to items in any order they choose.

Available options:
linear,
nonlinear
submissionMode
enum<string>
required

Determines how learner responses are submitted for response processing. 'individual' allows responses to be submitted as each item is completed, while 'simultaneous' means responses for all items are sent when the whole part is completed.

Available options:
individual,
simultaneous
qti-assessment-section
object[]
required
rawXml
string
required

Raw XML representation of the entity, automatically generated from the JSON or XML sent when creating entities on the service provider. The rawxml field will contain all content sent when creating the entity on the service provider. This field is stable and should be used when working within this QTI API.

content
object
required