Create a signed session to show a patient view in the practitioner portal
Called from the partner backend when a practitioner opens a patient. Returns a one-time URL (valid 5 minutes)
to load in an iframe or through the @eno/embed web SDK. The session then lasts up to 8 hours.
Requires a practitioner_access consent from the user covering the partner organization.
Every view is written to the access log against the practitioner.
Body·
required
application/json
- Properties: 4Type: objectpractitionerrequired
- Type:user
Id required - Type: stringFormat: uriallowed
Origin Must match an origin registered for the partner (enforced with CSP frame-ancestors).
- Type: stringlocale
- Type: array of stringenumpermissionsvaluesreadcommentcreate_recommendationcreate_goal
- Properties: 2Type: objecttheme
- Type: stringenumviewvaluesoverviewtimelinebiomarkerswearablesdocumentsinterviewsrecommendationsgoals
Responses
- application/json
- application/problem+json
Request Example for post/embed-sessions
curl https://api.eno.health/embed-sessions \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"userId": "usr_01JA2Y7Q3K8V5T0N4R6M2P9XWE",
"practitioner": {
"externalId": "",
"name": "",
"role": "physician",
"identifiers": [
{
"system": "be_riziv",
"value": ""
}
]
},
"view": "overview",
"permissions": [
"read"
],
"locale": "nl-BE",
"theme": {
"mode": "light",
"accentColor": ""
},
"allowedOrigin": "https://example.com"
}'
{
"id": "string",
"url": "https://example.com",
"urlExpiresAt": "2026-11-16T17:41:54.701Z",
"expiresAt": "2026-11-16T17:41:54.701Z"
}