Technical Tests
Manage technical tests and assign them to candidates as part of a recruitment process.
Required scope:
tests:read to read, tests:write to create and assign.List tests
GET
/api/v1/testsReturns the organization's library of technical tests.
Query Parameters
| Paramètre | Type | Requis | Description |
|---|---|---|---|
page | integer | Non | Page number (default: 1). |
pageSize | integer | Non | Results per page (default: 20). |
type | string | Non | Filter by type: KNOWLEDGE | TECHNICAL | PERSONALITY | LOGIC. |
difficulty | string | Non | Filter by difficulty: BEGINNER | INTERMEDIATE | ADVANCED | EXPERT. |
isPublished | boolean | Non | Return only published tests (default: true). |
Request
200 Response
Get a test
GET
/api/v1/tests/:idReturns the details of a technical test.
Path Parameters
| Paramètre | Type | Requis | Description |
|---|---|---|---|
id | string | Oui | Unique identifier of the test. |
Request
200 Response
Assign a test
POST
/api/v1/tests/:id/assignAssigns a test to a candidate and sends them the invitation.
Path Parameters
| Paramètre | Type | Requis | Description |
|---|---|---|---|
id | string | Oui | Identifier of the test to assign. |
Body Parameters
| Paramètre | Type | Requis | Description |
|---|---|---|---|
candidateId | string | Oui | Identifier of the candidate. |
stageId | string | Non | Pipeline stage to attach this session to. |
sendInvite | boolean | Non | Send the invitation by email (default: true). |
Request
201 Response