Initialize a client session

Exchange a client token for a browser chat session. Validates the token + request Origin, resolves the target flow or agent, and returns the session id plus widget display config. Pass an existing sessionId to reuse a prior conversation record.

Request

This endpoint expects an object.
tokenstringRequired>=1 character
flowIdstringOptional
sessionIdstringOptional

Response

Session created
configobject
expiresAtstring

ISO-8601 session idle-expiry timestamp.

flowobject
sessionIdstring

The created (or resumed) client session ID.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error