Minctrl Docs
API ReferenceEmbedding

Exchange an embed token for a widget session (once)

POST
/embed/session

The session is returned in the body, kept in the widget's memory and sent as a bearer — no cookie is set, so nothing is sent by the browser on its own.

The claimed parent_origin is checked against what the BROWSER says (review F9): when the request carries Origin, it must be Minctrl itself (the widget's own call) or the claimed parent; when it carries Sec-Fetch-Site other than same-origin, the Origin must be the claimed parent. A script outside a browser sends neither — that is the limit of a browser-side control: a stolen token is bounded by single use and ≤ 15 min.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/embed/session" \  -H "Content-Type: application/json" \  -d '{    "token": "string",    "parent_origin": "string"  }'
{}