Get One-off Hosted Session Link

POST

/hosted/sessions

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.

AuthorizationBearer

Authorization header using the Bearer scheme

This endpoint expects an object.

employer_idstringRequiredformat: "er_.+"

employee_idstringRequiredformat: "ee_.+"

linkstring

expirystringformat: "date-time"

1	import requests
2
3	url = "https://test.api.kota.io/hosted/sessions"
4
5	payload = {
6	"employer_id": "er_3b1333d87d9d4fd6ad83ba7f6b0e951a",
7	"employee_id": "ee_3b1333d87d9d4fd6ad83ba7f6b0e951a"
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())