Skip to main content
PUT
/
assessment-tests
/
{assessmentTestIdentifier}
/
test-parts
/
{testPartIdentifier}
/
sections
/
{identifier}
/
items
/
order
Reorder assessment items within a section
curl --request PUT \
  --url https://qti.alpha-1edtech.ai/api/assessment-tests/{assessmentTestIdentifier}/test-parts/{testPartIdentifier}/sections/{identifier}/items/order \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "identifier": "<string>",
      "href": "<string>",
      "sequence": 123
    }
  ]
}
'
{
  "identifier": "<string>",
  "title": "<string>",
  "visible": true,
  "required": true,
  "fixed": false,
  "sequence": 123,
  "qti-assessment-item-ref": [
    {
      "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 root assessment test

testPartIdentifier
string
required

The unique identifier of the parent test part

identifier
string
required

The unique identifier of the target section containing the items to reorder

Body

application/json

Array of assessment item references in the desired order

Update the presentation order of assessment item references within a section. All specified items must exist in the section on the service provider.

items
object[]
required

Array of assessment item identifiers with their updated sequence positions.

Minimum array length: 1

Response

Assessment item order updated successfully

Complete assessment section data with all referenced items. Represents a section containing learning content within a test part.

identifier
string
required

Unique identifier for the entity on the service provider.

title
string
required

Human-readable title of the entity on the service provider.

visible
boolean
default:true
required

Determines whether the assessment section is visible to candidates during test delivery. Sections are visible by default unless explicitly hidden for specific assessment conditions.

required
boolean
default:true

If a child element is required it must appear (at least once) in the selection.

fixed
boolean
default:false

If a child element is fixed it must never be shuffled. When used in combination with a selection rule fixed elements do not have their position fixed until after selection has taken place.

sequence
integer

Defines the sequential order of this item within its parent section. Must be a positive integer that determines presentation order to candidates.

qti-assessment-item-ref
object[]

Collection of assessment items that are referenced within this section.