You are integrating Telepatia Synapse Public API.
Endpoint: POST /v1/scribe-sessions/live
Base URL: https://scribe-api.telepatia.ai
Auth: Authorization: Bearer ${SYNAPSE_API_KEY}
Request:
- consultation [body]: object (required) — The caller's consultation reference.
- template [body]: object (required) — Template selection: an existing public id xor an inline structured template.
- patient [body]: object (required) — An existing patient by public id xor the inline identity.
- context [body]: object (optional) — Free-text context that feeds record generation.
Success 201:
- consultation: object
- status?: string
- live: object
Errors (envelope: { error: { type, code, message, param? } }):
- 400: parameter_missing, parameter_invalid, account_invalid
- 401: authentication_required
- 403: permission_denied, permission_denied_role
- 404: resource_not_found
- 409: resource_conflict
- 413: request_too_large
- 503: service_unavailable
Generate code in the language of the current file that:
1. Reads SYNAPSE_API_KEY from env (do not hardcode it).
2. Calls the endpoint with typed request and response.
3. Maps the error envelope to typed exceptions per status code.
4. Adds one happy-path test using the Bearer token.
