Skip to main content
POST
Mint an iframe embed session

Authorizations

Authorization
string
header
required

Partner API key. psk_test_<32 hex> for test mode, psk_live_<32 hex> for live mode. Keys are stored hashed and cannot be recovered; store them in your secrets manager on issue.

Path Parameters

groupId
string
required

Group ID, e.g. grp_8c2f41d09a3e.

Pattern: ^grp_[0-9a-f]{12}$

Response

Embed session created.

token
string
required

Short-lived session token. Send it to the embed endpoints as x-prescience-embed-token. Never expose your partner API key to the browser — only this token belongs client-side.

url
string<uri>
required

Fully formed iframe URL with the token already applied. Return this field from your backend to your frontend and use it as the iframe src. Do not persist it.

expiresAt
string<date-time>
required

Expiry, 30 minutes after minting. Mint a fresh session rather than reusing an expired one.