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: 4
  • Must match an origin registered for the partner (enforced with CSP frame-ancestors).

  • values
    readcommentcreate_recommendationcreate_goal
  • Properties: 2
  • values
    overviewtimelinebiomarkerswearablesdocumentsinterviewsrecommendationsgoals

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"
}
Partner API 0.1.0-draft.3 · Draft contract · Sandbox and SDK availability require confirmation.