Create a new session for a user.

POST

https://host.com/v1/sessions

X-API-Keystring

API Key authentication. Generate your API key in the Gail Portal under General > Integrations > API Keys.

The session creation request.

userKeystring or nullRequired

metadatamap from strings to strings or nullRequired

idstringformat: "uuid"

The unique identifier for the session.

userKeystring or null

The unique identifier of the user associated with the session.

metadatamap from strings to strings or null

Additional metadata associated with the session or user.

issuedAtdatetime

The timestamp when the session was issued.

expiresAtdatetime

The expiration timestamp of the session.

400

Bad Request Error

1	const url = 'https://host.com/v1/sessions';
2	const options = {
3	method: 'POST',
4	headers: {'X-API-Key': '<apiKey>', 'Content-Type': 'application/json'},
5	body: '{"userKey":"string"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}