> ## Documentation Index > Fetch the complete documentation index at: https://docs.timeback.com/llms.txt > Use this file to discover all available pages before exploring further. # Add an assessment item reference to a section > Add a reference to an existing assessment item in a section. This creates a link between the assessment item and the section without copying the item content. The item must exist in the assessment-items collection. ## OpenAPI ````yaml /openapi/beyond-ai/qti-api.yaml post /assessment-tests/{assessmentTestIdentifier}/test-parts/{testPartIdentifier}/sections/{identifier}/items openapi: 3.1.0 info: title: QTI API version: 1.0.0 description: >- A robust assessment engine implementing the QTI 3.0 specification, designed for creating, managing, and delivering educational assessments. servers: - url: https://qti.alpha-1edtech.ai/api description: Main Server security: - OAuth2: [] - MCP: [] tags: - name: Validation description: >- Validate XML strings against QTI compliant XSD files. XSD version supported is 3.0.0 (3p0) - name: Feedback description: Feedback for questions and lessons - name: Assessment Test Management description: >- Enables the management of Assessment Tests. Assessment Tests are the main entities that contain Assessment Test Parts, Sections, and Assessment Items. - name: Test Part Management description: >- Enables the management of Test Parts. Assessment Test Parts are used to group sections inside of an Assessment Test. - name: Section Management description: >- Enables the management of Sections. Assessment Sections are used to group Assessment Items. - name: Assessment Item Management description: >- Enables the management of Assessment ITems. Assessment Items are made up of QTI Interactions (e.g. questions, multiple choice, etc.). - name: Stimulus Management description: >- Enables the management of Stimuli. Stimuli are shared content pieces (text, images, audio, video) that provide context for assessment items and can be referenced by multiple questions. paths: /assessment-tests/{assessmentTestIdentifier}/test-parts/{testPartIdentifier}/sections/{identifier}/items: post: tags: - Section Management summary: Add an assessment item reference to a section description: >- Add a reference to an existing assessment item in a section. This creates a link between the assessment item and the section without copying the item content. The item must exist in the assessment-items collection. operationId: addAssessmentItem parameters: - name: assessmentTestIdentifier description: Root assessment test identifier in: path required: true schema: type: string - name: testPartIdentifier description: Parent test part identifier in: path required: true schema: type: string - name: identifier description: Section identifier in: path required: true schema: type: string requestBody: description: The assessment item identifier to add to the section required: true content: application/json: schema: type: object properties: identifier: type: string description: Unique identifier for the entity on the service provider. href: type: string description: >- URI reference to the assessment item resource location on the service provider sequence: type: integer exclusiveMinimum: 0 description: >- Defines the sequential order of this item within its parent section. Must be a positive integer that determines presentation order to candidates. required: - identifier description: >- Add a reference to an existing assessment item in a section. The assessment item must exist in the assessment-items collection on the service provider. responses: '201': description: Assessment item reference added successfully content: application/json: schema: type: object properties: identifier: type: string description: Unique identifier for the entity on the service provider. title: type: string description: >- Human-readable title of the entity on the service provider. visible: type: boolean default: true description: >- 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: type: boolean default: true description: >- If a child element is required it must appear (at least once) in the selection. fixed: type: boolean default: false description: >- 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: type: integer exclusiveMinimum: 0 description: >- 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: type: array items: type: object properties: identifier: type: string description: >- Unique identifier for the entity on the service provider. href: type: string description: >- URI reference to the assessment item resource location on the service provider required: - identifier description: >- Assessment item reference schema for linking assessment items to sections description: >- Collection of assessment items that are referenced within this section. qti-pre-condition: type: array items: type: object additionalProperties: {} description: >- Array of QTI 3.0 pre-conditions. Each pre-condition contains a logical expression that is evaluated before the element is presented. If any pre-condition evaluates to false, the element is skipped. qti-branch-rule: type: array items: type: object additionalProperties: {} description: >- Array of QTI 3.0 branch rules. Each branch rule contains a logical expression that, when evaluated to true after the element is presented, causes the test to jump to the target identified by the rule. required: - identifier - title - visible description: >- Complete assessment section data with all referenced items. Represents a section containing learning content within a test part. '400': description: Missing assessment item identifier or item already exists in section content: application/json: schema: type: object properties: error: type: string details: type: string required: - error '404': description: Assessment test, test part, section, or assessment item not found content: application/json: schema: type: object properties: error: type: string required: - error '500': description: Internal Server Error content: application/json: schema: type: object properties: error: type: string description: Error type identifier message: type: string description: Human-readable error message eventId: type: string description: Sentry event ID for error tracking details: type: string description: Stack trace or additional error details required: - error - message - details description: Internal server error response components: securitySchemes: OAuth2: type: oauth2 flows: clientCredentials: scopes: https://purl.imsglobal.org/spec/qti/v3/scope/readonly: Read access to QTI https://purl.imsglobal.org/spec/qti/v3/scope/createput: Create and update access to QTI https://purl.imsglobal.org/spec/qti/v3/scope/delete: Delete access to QTI tokenUrl: >- https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/token MCP: type: oauth2 flows: authorizationCode: authorizationUrl: >- https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/authorize tokenUrl: >- https://prod-beyond-timeback-api-2-idp.auth.us-east-1.amazoncognito.com/oauth2/token scopes: https://purl.imsglobal.org/spec/qti/v3/scope/readonly: Read access to QTI ````