Overview
Caliper
CASE
CLR
EduBridge
OneRoster
PowerPath
QTI
Timeback Events
Webhooks
curl --request POST \
--url https://api.alpha-1edtech.ai/powerpath/makeExternalTestAssignment \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"student": "<string>",
"lesson": "<string>",
"applicationName": "<string>",
"testId": "<string>",
"skipCourseEnrollment": true
}
'{
"toolProvider": "edulastic",
"lessonType": "test-out",
"attempt": 123,
"credentials": {
"email": "[email protected]",
"password": "<string>"
},
"assignmentId": "<string>",
"classId": "<string>",
"testUrl": "<string>",
"testId": "<string>"
}Make external test assignment
Makes an external test assignment for the given student:
- Applies to ‘test-out’, ‘placement’, and ‘unit-test’ lessons.
This logic changes depending on the provided “toolProvider” value:
- For “edulastic”:
- Authenticates the student with their email on Edulastic
- Assigns the test to the student in Edulastic
- Stores the received “assignmentId” and “classId” in the lesson’s AssessmentResult
- Returns the test link, credentials, and IDs of the test for later results consumption
- For “mastery-track”:
- Authenticates the student with their email on MasteryTrack
- Assigns the test to the student in MasteryTrack (using the testId in the request or subject+grade from the lesson’s Resource metadata)
- Stores the received “assignmentId” in the lesson’s AssessmentResult
- Returns the test link, credentials, and IDs of the test
- Waits for a test result write-back to be performed by the MasteryTrack on test end Will fail if:
- The lesson is not an external “test-out”, “placement”, or “unit-test”, or the student does not exist
- External tool (described in the resource.metadata.toolProvider) is not “edulastic” or “mastery-track”
- Any other problem on the Edulastic or MasteryTrack API being used that may happen
A ‘Lesson’ in this context is a ComponentResource object which has a Resource object with lessonType = “test-out”, “placement”, or “unit-test” associated with it.
curl --request POST \
--url https://api.alpha-1edtech.ai/powerpath/makeExternalTestAssignment \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"student": "<string>",
"lesson": "<string>",
"applicationName": "<string>",
"testId": "<string>",
"skipCourseEnrollment": true
}
'{
"toolProvider": "edulastic",
"lessonType": "test-out",
"attempt": 123,
"credentials": {
"email": "[email protected]",
"password": "<string>"
},
"assignmentId": "<string>",
"classId": "<string>",
"testUrl": "<string>",
"testId": "<string>"
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
The sourcedId of the student
The sourcedId of the lesson (ComponentResource)
The name of the application to use for authenticating on the external tool
The specific test ID to assign for MasteryTrack tool provider. If provided, overrides subject+grade selection.
When true, skips automatic course enrollment after test completion. Only applies to the current attempt.
Response
Success
edulastic, mastery-track test-out, placement, unit-test The attempt number
The credentials for accessing the assigned test on external tool
Show child attributes
Show child attributes
The id of the assignment on external tool for results retrieval
The id of the class on external tool for results retrieval (may be empty for some tools)
The URL of the test on external tool
The id of the test on external tool (may be assignment ID for some tools)