Create test assessment

Create an assessment for an already existing test

post

Returns a single assessment

Authorizations

api_key

Path parameters

organizationstringRequired

Name of the organization | can be found in the URL

teststringRequired

id of the test to return

Body

application/x-www-form-urlencoded

emailstringOptional

Email of the candidate

firstnamestringOptional

Firstname of the candidate

lastnamestringOptional

Lastname of the candidate

notifybooleanOptional

Should we notify users for the assessment that will be taken

Responses

200

successful operation

application/json

400

Invalid Assessment

404

Assessment not found

post

/{organization}/tests/{test}/assessments

HTTPcURLJavaScriptPython

POST /{organization}/tests/{test}/assessments HTTP/1.1
Host: 
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 67

"email='text'&firstname='text'&lastname='text'&notify=true"

{
  "guid": "text",
  "created_at": "2025-12-09T18:28:08.894Z",
  "updated_at": "2025-12-09T18:28:08.894Z",
  "unlocked_at": "2025-12-09T18:28:08.894Z",
  "tests_id": 1,
  "candidate_id": 1,
  "archived": true,
  "locked": true,
  "anonymized": true,
  "status": "text",
  "time": 1,
  "human_time": "text",
  "rating": 1,
  "remark": "text",
  "time_limit": 1,
  "human_time_limit": "text",
  "breaks": "text"
}