Session Adjustments endpoint

Apply score adjustments at the session level and/or individual response level.

You would want to use this to add or subtract points from a session's total score, or to adjust the score of individual Question responses within a session. This is useful for manual grading corrections, extra credit, or score moderation workflows.

The adjustment is processed asynchronously via a job. Use the GET /jobs endpoint with the returned job_reference to check the status of the job.

Endpoints:

• Update Session Adjustments

Usage

The format of requests to the Data API uses the following syntax:

https://data.learnosity.com/{LTS_VERSION}/{endpoint}

For example, to use the v2025.2.LTS version and the /sessions/{session_id}/adjustments endpoint, you would create a request like so:

https://data.learnosity.com/v2025.2.LTS/sessions/{session_id}/adjustments

Important The Data API is not a REST API. All requests must use the POST method, with the action request body parameter specifying the operation to use. The Learnosity SDK must be used to make requests to Data API.

Note The Data API usage is subject to rate limits.

Related articles:

• Getting Started with the Data API
• See Release Cadence and Version Lifecycle for more information on available LTS versions.

Applies score adjustments to a session and/or its individual Question responses.

At least one of session_adjustment_points or responses must be provided. Both can be provided together in a single request.

Score calculation

Response-level adjustment:

score_after_adjustment = score + adjustment_points

Session-level score:

session_score = SUM(score_after_adjustment for all responses) + session_adjustment_points

Note Calling this endpoint will overwrite any previous adjustment values. It does not add to existing adjustments.

Request body parameters

Body content type: application/json

• session_adjustment_points number

  Points to add or subtract at the session level. This value is added to the sum of all response scores to calculate the final session score.

  Use positive values to award extra points. Use negative values to apply a penalty.

• responses array[object]

  An array of response-level adjustment objects. Each object specifies the response to adjust and the points to apply.

  Maximum entries: 500

  The following properties are supported.

  • response_id string

    The response identifier. Must match an existing response in the specified session.

  • adjustment_points number

    Points to add or subtract from this response's score.

    Use positive values to award extra points. Use negative values to apply a penalty.

Request body example

{
    "session_adjustment_points": 5.0,
    "responses": [
        {
            "response_id": "my-session-id_response-1",
            "adjustment_points": 2.5
        },
        {
            "response_id": "my-session-id_response-2",
            "adjustment_points": -1.0
        }
    ]
}

Responses

The request has been accepted and a job has been created. Use the job_reference to poll the GET /jobs endpoint for the status and result of the adjustment.

Completed job result

When the job completes successfully, the result includes the updated session scores:

• session_id - The session that was adjusted.
• adjustment_points - The session-level adjustment applied.
• responses_updated - The number of responses that were adjusted.
• total_response_adjustment_points - The sum of all response-level adjustments applied.

Response example

{
    "meta": {
        "status": true,
        "timestamp": 1733825442
    },
    "data": {
        "job_reference": "58023cd7-3158-4b47-9708-34f976466cd7"
    }
}