v4

latestOpenAPI 3.1.02026-08-086635375.7 KB

Sessions

create widget session token

Create a session token for a configured widget. The request origin must be allowed by the persona's widget configuration unless the widget is configured to allow every origin. When watermark removal is configured, the token also requests removal of the AI avatar disclosure; the engine re-checks the organization's current entitlement when the session starts.

post/v1/auth/widget

Headers

Originstring uri

Origin of the page hosting the widget. Required unless the widget allows every origin.

Request body

agentIdstring required

ID of the persona used by the widget.

Example request

{
  "agentId": "071b0286-4cce-4808-bee2-e642f1062de3"
}

Response

Widget session token created.

sessionTokenstring required

Short-lived token accepted by POST /v1/engine/session.