API Reference

Create a company test library

post
https://api.testlify.com/v1/test/library

Creates a new test library owned by your organization.

Behavior to be aware of:

  • Your organization's daily and monthly test-creation limit is checked first; exceeding either returns an error.
  • If testLibraryTypeId is supplied, it must reference an existing test library type — use List test library types to get valid options.
  • If testCategory is supplied, every id must reference an existing category — use List test categories to get valid options.
  • If setTimeAt is set to question-level timing, timeLimit is ignored (timing is controlled per question instead). If test-level timing is used and timeLimit is 0, the test is treated as unlimited-time.
  • A newly created library always starts in DRAFT status, even if PUBLISHED is sent — a library with no questions cannot be published yet.
  • orgId is determined by your authentication token; it is not read from the request body.
  • A default question-selection preset is created automatically; you don't need to send one.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Test library details.

Fields you can set when creating or updating a test library.

string
required
length between 1 and 100

The library's name, 1–100 characters.

string
length between 0 and 4000

A short overview of the test, 0–4000 characters.

string
length between 0 and 10000

A longer description of the test, 0–10000 characters.

string
length between 0 and 10000

Instructions shown to candidates before taking the test.

boolean
Defaults to false

Whether the instructions above override the default instructions.

boolean
Defaults to false
string
length between 0 and 4000

Who this test is relevant for.

skills
array of objects
required
length ≥ 1

Skills covered by this test. At least one required. A skill still linked to an existing question cannot be removed.

skills*
jobRoles
array of numbers
length between 1 and 50

Job role codes this test is associated with.

jobRoles
string
required

The test library type this test belongs to. Get valid values from List test library types.

testCategory
array of strings

Category identifiers for this test. Get valid values from List test categories.

testCategory
string
enum
Defaults to English Speaking

The language audience this test targets.

string
enum

Overall difficulty level of the test.

Allowed:
integer
≥ 0
Defaults to 20

Number of questions candidates will be given.

number
Defaults to 1200

Total time allowed for the test, in seconds. Ignored when timing is set per-question.

number
≥ 0

Additional time granted, in seconds.

string
enum

Publication status. On update, this is always recalculated from the library's current question count and any value you send is not used.

Allowed:
codingLanguages
array of strings

Coding languages available for coding questions in this library.

codingLanguages
boolean
Defaults to false
string
required
Defaults to English

Primary language of the test content.

boolean
Defaults to true

Whether question order is shuffled for each candidate.

boolean
Defaults to true

Whether answer option order is shuffled for each candidate.

string
enum

Whether the time limit applies to the overall test or to each question individually.

Allowed:
string
enum
Defaults to ALL

How the number of questions presented to a candidate is determined.

Allowed:
boolean
Defaults to false

Whether this test is used for 360-degree feedback reviews.

Responses

Updated 9 days ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 9 days ago

Did this page help you?