Create a self-elected student test-out assignment

curl --request POST \
  --url https://api.alpha-1edtech.ai/powerpath/test-out/makeExternalStudentTestOutAssignment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "oneRosterSourcedId": "<string>",
  "subject": "<string>"
}
'

{
  "success": true,
  "data": {}
}

Test Out

Create a self-elected student test-out assignment

Creates an AlphaTest test-out assignment for a student on a given subject.

The endpoint performs the following steps:

Looks up the student’s email using their OneRoster sourcedId
Checks eligibility: the student must have an active enrollment in a non-placeholder course for the subject
Fetches the student’s highest grade mastered for the given subject
If the highest grade mastered is available, assigns a test-out at the next grade level (highestGradeMastered + 1)
If the highest grade mastered is not available, falls back to the active course sequence to determine the lowest assessment grade for the subject and uses that as the test-out grade

The assignment payload sent to AlphaTest includes:

test_type: “test out”
origin: “self-elected”

Will fail if:

The student does not exist or has no email
The student does not have an active enrollment for the subject (or the course has placementPlaceholder set to true)
The test-out grade cannot be determined (no highest grade mastered and no active course sequence with assessment stages)
The AlphaTest API returns an error

POST

powerpath

test-out

makeExternalStudentTestOutAssignment

Create a self-elected student test-out assignment

curl --request POST \
  --url https://api.alpha-1edtech.ai/powerpath/test-out/makeExternalStudentTestOutAssignment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "oneRosterSourcedId": "<string>",
  "subject": "<string>"
}
'

{
  "success": true,
  "data": {}
}

Authorizations

Authorization

string

header

required

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

Body

application/json

oneRosterSourcedId

string

required

The OneRoster sourcedId of the student who will take the test

Minimum string length: 1

subject

string

required

The subject for which the student will test out (e.g. Math, Reading, Language, Science, Writing, Vocabulary)

Response

Assignment created

success

boolean

required

data

object

Show child attributes

Check if a student is eligible to self-request a test-out

Get course sequences

⌘I

Documentation Index

Authorizations

Body

Response