document.generationFailed

Event Properties

Field	Value
`event`	`"document.generationFailed"`
`confidential`	`boolean`
`payload`	`object`

Public Payload
Confidential Payload

Field	Type	Description
`reason`	`string`	Human-readable description of the failure
`errorCode`	`string`	Machine-readable error identifier
`documentId`	`string`	Unique document identifier
`documentName`	`string`	Document name or title
`outputLanguage`	`string`	Output language code (e.g., “en”, “de”)
`templateType`	`"built-in" \| "custom"`	Type of template used: built-in or custom
`templateId`	`string`	Template identifier (either ref for built-in or customTemplateId for custom)
`interactionId`	`string`	Unique interaction identifier
`interactionState`	`InteractionState`	Current state of the interaction

Example

{
  "event": "document.generationFailed",
  "confidential": false,
  "payload": {
    "reason": "timeout",
    "errorCode": "timeout",
    "documentId": "doc_123",
    "documentName": "SOAP note",
    "outputLanguage": "en",
    "templateType": "built-in",
    "templateId": "soap",
    "interactionId": "int_123",
    "interactionState": "ongoing"
  }
}

Field	Type	Description
`reason`	`string`	Human-readable description of the failure
`errorCode`	`string`	Machine-readable error identifier
`document`	`ExternalPatientDocument`	Complete document object with all sections and metadata
`interaction`	`ExternalInteraction`	Interaction context including transcripts, documents, and facts

document object properties

Field	Type	Description
`id`	`string`	Unique document identifier
`name`	`string`	Document name or title
`outputLanguage`	`string`	Output language code (e.g., “en”, “de”)
`sections`	`Section[]`	Document sections containing the generated content
`templateType`	`"built-in" \| "custom"`	Type of template used: built-in or custom
`templateId`	`string`	Template identifier (either ref for built-in or customTemplateId for custom)

Section properties:

Field	Type	Description
`key`	`string`	Unique key identifying the section type
`name`	`string`	Display name of the section
`text`	`string`	Section content in markdown or plain text

interaction object properties

Field	Type	Description
`id`	`string`	Unique interaction identifier
`title`	`string \| null`	Interaction title
`state`	`InteractionState`	Current state of the interaction
`startedAt`	`string (ISO 8601 date)`	When the interaction started (ISO 8601 date string)
`transcriptCount`	`number`	Number of transcripts in the interaction
`documentCount`	`number`	Number of documents in the interaction
`facts`	`Fact[]`	Facts extracted during the interaction

Fact properties:

Field	Type	Description
`id`	`string`	Unique fact identifier
`text`	`string`	Fact text content
`group`	`string`	Fact group/category name
`source`	`"core" \| "system" \| "user"`	Source of the fact: core (AI extracted), system, or user
`isDiscarded`	`boolean`	Whether the fact has been discarded

Example

{
  "event": "document.generationFailed",
  "confidential": true,
  "payload": {
    "reason": "timeout",
    "errorCode": "timeout",
    "document": {
      "id": "doc_123",
      "name": "SOAP note",
      "outputLanguage": "en",
      "sections": [
        {
          "key": "hpi",
          "name": "HPI",
          "text": "..."
        }
      ],
      "templateType": "built-in",
      "templateId": "soap"
    },
    "interaction": {
      "id": "int_123",
      "title": "Visit",
      "state": "ongoing",
      "startedAt": "2024-01-01T00:00:00.000+00:00",
      "transcriptCount": 0,
      "documentCount": 0,
      "facts": []
    }
  }
}

Overview

Get Started

Integrations

API Reference

Events

Event Properties

Example

Example

Overview

Get Started

Integrations

API Reference

Events

​Event Properties

​Example

​Example

Event Properties

Example

Example