Create test

Create a test in an organization

post

Authorizations

api_key

Path parameters

organizationstringRequired

Name of the organization | can be found in the URL

Body

application/x-www-form-urlencoded

namestringOptional

Name of the test

passwordstringOptional

Password of the test

skillareasinteger[]Optional

Array of skill areas to be included into the assessment

Responses

200

successful operation

application/json

Test is the test that is created by the organization that can contain a test for one or more skill area

idinteger · int64Optional

Unique identifier of the skillaera

created_atstring · date-timeOptional

Date when the test is created

ended_atstring · date-timeOptional

Date when the test ends

namestringOptional

Name of the test

archivedbooleanOptional

Is the test archived

urlstringOptional

URL where the test can be taken by the candidate

time_limitstringOptional

Test approximate timelimit in seconds | time limit is the average time the test will have depending on the questions that the candidate will get from the pool

passwordstringOptional

Password used to take the test without social login

post

/{organization}/tests

HTTPcURLJavaScriptPython

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

"name='text'&password='text'&skillareas=[1]"

200

successful operation

{
  "id": 1,
  "created_at": "2026-03-23T19:13:49.114Z",
  "ended_at": "2026-03-23T19:13:49.114Z",
  "name": "text",
  "archived": true,
  "url": "text",
  "time_limit": "text",
  "password": "text"
}