StartExam API

Register Program Employees

Method registers or unregisters employees for a given program.

Request Information

Scheme

POST https://api.startexam.com/v1/program/employees

URI Parameters

None

Body Parameters

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.

Request Example

Example 1: all scope: register / unregister for all tests at once.
Example 2: 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: 274
Date: Mon, 02 Feb 2026 13:32:48 GMT

{
  "programId": "babe6e82-cb63-4239-be02-a5bb7064b903",
  "programExternalId": null,
  "moduleTestsScope": "all",
  "moduleTests": null,
  "registerEmployees": [
    "10965",
    "10808",
    "10576",
    "10659",
    "10963",
    "10962"
  ],
  "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: 431
Date: Mon, 02 Feb 2026 13:32:48 GMT

{
  "programId": "2afdf12c-5eae-4448-8695-63e3a25cf9f0",
  "programExternalId": null,
  "moduleTestsScope": "selected",
  "moduleTests": [
    "2e2a4ab2-1cc3-4d4a-917e-659410596eed",
    "fc837753-c7c3-4f58-a3ac-5ea0c63796ab",
    "bdcaa06d-a833-4f5e-a8ad-8412a41c87f7",
    "9b8e70d5-e6c9-4eab-b8eb-452b4e00a2e8"
  ],
  "registerEmployees": [
    "10768",
    "10755"
  ],
  "unregisterEmployees": [
    "11932",
    "11508"
  ]
}

Date and Authorization headers are constructed in the standard way.

Response Information

HTTP status code

200 OK, 400 Bad Request, etc. according the response processing guide.

Content-Type

Json.

Content

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.

Response Example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 151

{
  "employeesRegistered": 6,
  "attemptsRegistered": 12,
  "employeesUnregistered": 0,
  "attemptsUnregistered": 0,
  "totalEmployeesInProgram": 100
}

Try Method