The Basics of Testinvite's API

What is an Organization?

When you sign up for a new account for Testinvite, a new Organization is created.

You can find your Organization ID by following the below steps:

• Log into your account.
• Click "Organization" on the left-menu.
• Click on info icon

What is a Task?

In Testinvite a Task defines an assessment process. Each Task is a container for one or multiple tests along with all the configuration about how the tests will be conducted.

When you invite a candidate into your Task, the candidate gets access to the Tests inside your Task. The tests are delivered according to the configuration made inside the Task.

You can find your Task's ID by following the below steps:

• Log into your account.
• Click "Tasks" on the menu on the left. You Tasks will be listed in a table.
• Click on the Task whose id you would like to learn. The Task editor will show up.
• Under Settings card in Dashboard tab, turn on Detailed view.
• You will see the Task's ID at the top of Settings card

What is a Ticket?

In order to invite a candidate into your Task, you need to create a Ticket. All tickets created are assigned a unique invitation code by the system automatically. In the most common scenario, the end-user (test-taker) will enter the unique invitation code so that he/she will be granted to access the Tests inside your Task.

What is a Task link?

All Tasks in Testinvite are given a Task link. The Task link is constant for a Task. It does not change.

Task links are public, meaning that anyone having the link can navigate to the link.

Task link can be found in the Settings card of Dashboard tab in the Task Editor.

When somebody navigates to the Task link, he/she faces the Welcome page of the Task. The content (1) inside the Welcome page can be configured inside the Task editor.

The Welcome page is where the login credentials are asked (2) from the test-taker.

What is an Access link?

If you do not want to bother test-takers with entering their unique invitation code on the Task's Welcome page, you can send them an Access link instead of the Task link.

An Access link is a combination of the Task link and the unique invitation code of a Ticket. You can find a Ticket's Access link by following the below steps:

• Navigate to your Task editor.
• Click on the Tickets Tab (1) button at the top.
• Find the desired Ticket by querying the Tickets by clicking on Load/Next (2)
• Click (3) on the kebab menu icon next to the Ticket you would like to get the Access link
• Click on Copy Access Link

When someone navigates to the Access link, he/she bypasses the Welcome page of a Task, and immediately enters into the Task and a new Assessment including all the Tests inside your Task gets created.

What is a Test Session?

When a test-takers enters into your Task, he/she is presented with all the Tests inside your Task. When the test-taker starts a Test, a Test session is created.

You can find all the Test sessions inside your Task editor by navigating to the Test sessions tab at the top. You can browse through all the Test sessions that have been created.

Each Test session is automatically assigned a unique Test Session ID. The ID of each Test session is displayed at the Test sessions list.