v2

latestOpenAPI 3.1.12026-08-0785394779.1 KB
Hosted Sessions

Get One-off Hosted Session Link

Retrieve a hosted link to authenticate an employee with the Kota Hosted. This link is valid for a single use and expires after 60 minutes.

post/hosted/sessions

Request body

employer_idstring required
employee_idstring required

Example request

{
  "employer_id": "er_3b1333d87d9d4fd6ad83ba7f6b0e951a",
  "employee_id": "ee_3b1333d87d9d4fd6ad83ba7f6b0e951a"
}

Response

OK

linkstring required
expirystring date-time required

Example response

{
  "expiry": "2024-12-01T00:00:00Z"
}