Method registers or unregisters employees for a given program.
POST https://api.startexam.com/v1/program/employees
None
Json with a RegisterProgramEmployeesQuery:
ProgramId
- Program identifier, guid from StartExam.
ProgramExternalId
- Program external identifier. Pass your own string ID from integrated system rather than guid from StartExam for easier integration (optional).
ModuleTestsScope
- pass all
to apply action for all tests in a program,
or pass selected
to apply action only for selected tests in a program.
ModuleTests
- identifiers of specific module tests, guids from StartExam.
Used only for ModuleTestsScope
= selected
and manual
program mode.
RegisterEmployees
- Identifiers of employees to register. One request must not contain more than 500 employees to register.
UnregisterEmployees
- Identifiers of employees to unregister. One request must not contain more than 500 employees to unregister.
all
scope: register / unregister for all tests at once.selected
scope: register / unregister for specified tests.POST https://api.startexam.com/v1/program/employees HTTP/1.1
Host: api.startexam.com
Accept: application/json; charset=utf-8
Authorization: SharedKey 99:f52JP7GQd0xqrBzMO1NWTNVGzLENymgdUXu/Ie++NX4=
Content-Type: application/json; charset=utf-8
Content-Length: 235
Date: Sat, 05 Jul 2025 22:00:44 GMT
{
"programId": "ae5bf69f-a9db-4025-a619-33236ec53405",
"programExternalId": null,
"moduleTestsScope": "all",
"moduleTests": null,
"registerEmployees": [
"10812",
"10810",
"10613"
],
"unregisterEmployees": []
}
POST https://api.startexam.com/v1/program/employees HTTP/1.1
Host: api.startexam.com
Accept: application/json; charset=utf-8
Authorization: SharedKey 99:f52JP7GQd0xqrBzMO1NWTNVGzLENymgdUXu/Ie++NX4=
Content-Type: application/json; charset=utf-8
Content-Length: 372
Date: Sat, 05 Jul 2025 22:00:44 GMT
{
"programId": "dbcb061a-68ea-447c-88b1-4629e7b6bfd5",
"programExternalId": null,
"moduleTestsScope": "selected",
"moduleTests": [
"9b59cc2b-351f-4a37-891e-dcf4a5206170",
"65460246-af21-41b1-90c8-acbe8926fca6",
"62e3bfa8-3f77-48c6-b9ff-8240565a5bd0"
],
"registerEmployees": [
"10748",
"10980",
"10623"
],
"unregisterEmployees": []
}
Date and Authorization headers are constructed in the standard way.
200 OK, 400 Bad Request, etc. according the response processing guide.
Json.
Method returns operation results:
EmployeesRegistered
- number of new employees added to the program.
AttemptsRegistered
- number of attempts created.
EmployeesUnregistered
- number of employees removed from the program.
AttemptsUnregistered
- number of attempts removed.
TotalEmployeesInProgram
- total number of employees in the program after operation.
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 151
{
"employeesRegistered": 3,
"attemptsRegistered": 12,
"employeesUnregistered": 0,
"attemptsUnregistered": 0,
"totalEmployeesInProgram": 100
}